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如 何 学 习 Android 开 发 


对 新 手 来 说 ， 学 习 Android 开 发 一 开始 会 很 难 。 就 像 初次 踏 入 开国 他 乡 
一 样 ， 即 使 会 说 当地 语言 ， 一 开始 也 绝 不 会 有 舒服 目 在 的 感 党。 周围 人 
人 原 有 的 知识 储备 在 新 环境 下 也 完全 派 不 上 
用 场 。 


Android 有 自己 的 语言 文化 使 用 Kotlin 或 Java 语 言 (或 者 两 者 兼 而 有 
Z) 。 但 要 深入 理解 Android， 仅 掌握 Kotlin 或 Java 还 不 够 ， 你 还 需要 学 
习 诸 多 新 理论 和 新 技术 。 涉 足 陌 生 领 域 时 ， 有 个 同 导 会 很 有 帮助 。 


这 惑 是 我 们 的 作用 所 在 。 在 Big Nerd Ranch， 我 们 认为 ， 要 成 为 一 名 
Android 开 发 人 员 ， 你 必须 : 


e 着 手 开 发 一 些 Android 应 用 ; 
© 充分 理解 你 的 Android 应 用 。 


本 书 将 协助 你 完成 以 上 两 件 事 。 我 们 用 它 成 功 培 训 了 数 干 名 专业 的 
Android 开 友人 员 。 本 书 将 指导 你 开发 多 个 Android 应 用 ， 并 根据 需要 介 
绍 各 种 概念 和 技术 。 在 学 习 过 程 中 ， 如 果 遇 到 知识 疑难 点 ， 请 勇敢 面 
对 。 我 们 也 会 尽 最 大 努力 抽 丝 剥 盏 ， 让 你 知 其 然 更 知 其 所 以 然 。 


我 们 的 教学 方法 是 : 在 学 习 理论 的 同时 ， 就 着 手 运 用 它们 开发 实际 的 应 
用 ， 而 非 先 学 习 一 大 挫 理 论 ， 再 考虑 如 何 将 其 应 用 于 实践 。 读 完 本 书 ， 
你 将 有 具备 必要 的 开发 经 验 和 知识 。 以 此 为 起 点 ， 深 入 学 习 ， 你 会 逐渐 成 
长 为 一 名 合格 的 Android 开 发 者 。 


网 读 前 所 
使 用 本 书 ， 你 需要 熟悉 Kotlin 语 言 ， 包 括 类 、 对 象 、 接 口 、 监 听 器 、 
包 、 内 部 类 、 对 象 表达 式 以 及 泛 型 类 等 基本 概念 。 


如 果 不 熟 悉 这 些 概念 ， 没 翻 几 页 你 就 会 看 不 下 去 了 。 对 此 ， 建 议 先 放下 
本 书 ， 找 本 Kotlin 入 门 书 看 一 看 。 市 面 上 有 很 多 优秀 的 Kotlin 入 门 书 ， 你 
可 以 基于 自己 的 编程 经 验 及 学 习 风 格 去 挑选 。 或 许 你 可 以 看 看 《Kotlin 


编程 权威 指南 》! 这 本 书 。 


! 此 书 已 由 人 民 邮 电 出 版 社 出 版 ， 详 情 请 见 图 灵 社 区 。 一 编者 注 


如 果 你 熟悉 面向 对 象 编程 ， 但 Kotlin 知 识 掌握 得 不 牢靠 ， 那 么 阅读 本 书 
应 该 不 会 有 太 大 问题 。 碰 到 Kotlin 语 言 点 ， 我 们 会 进行 简单 的 解释 。 不 
过 ， 在 学 习 的 过 程 中 ， 还 是 建议 手边 备 上 一 本 Kotlin 参 考 书 ， 以 方便 奉 
阅 。 


第 4 版 有 哪些 变化 


第 4 版 是 一 次 重大 更 新 ， 每 一 章 的 内 容 都 做 了 修改 。 要 说 最 大 的 变化 ， 
当 数 应 用 开发 语言 从 Java 换 成 了 Kotlin。 因 为 这 个 缘故 ， 我 们 私下 称 第 4 
版 为 “Android 4K”. 


另 一 个 重大 改变 是 全 面 引入 了 Android Jetpack 组 件 库 。 第 4 版 使 用 Jetpack 
库 《〈 又 称 AndroidX) 代 蔡 了 原来 的 文 持 库 。 而 且 ， 只 要 有 可 能 ， 我 们 就 
会 整合 使 用 全 新 的 Jetpack API。 例 如 ， 第 4 版 会 使 用 ViewMode1 来 处 理 
设备 旋转 的 UI 状态 持久 化 问题 ， 使 用 Room 和 LiveData 来 实现 数据 库 及 
其 数据 查询 ， 使 用 WorkManager 来 调度 后 台 工 作 ， 等 等 。 在 学 习 过 程 
中 ， 你 还 会 在 一 个 个 项 目的 开发 中 看 到 更 多 Jetpack 组 件 的 应 用 。 


为 重点 关注 现代 Android 应 用 是 如 何 开 发 的 ， 除 了 Android 框 架 本 号 以 及 
Jetpack 内 的 API， 第 4 版 开始 使 用 第 三 方 库 。 例 如 ， 书 中 优先 使 用 
Retrofit 及 其 依赖 库 ， 而 非 原来 的 HttpURLConnection 和 一 些 低级 别 的 
网 络 API。 相 比 之 前 的 版 本 ， 这 属于 很 大 的 改变 ， 我 们 认为 这 有 助 于 读 
者 更 好 地 适应 专业 的 Android 应 用 开发 。 而 且 ， 书 中 选用 的 这 些 第 三 方 
库 也 是 我 们 为 客户 开发 应 用 时 日 常 使 用 的 。 


Kotlin 5 Java 


Kotlin 获 Android 开 发 官方 支持 是 在 2017 年 的 Google IO 大 会 上 宣布 的 。 
在 那 之 前 ， 一 直 是 民间 Android 开 发 者 力量 在 推动 使 用 Kotlin。 自 2017 年 
官 宣 后 ，Kotlin 已 被 人 们 广 为 接受 ， 并 迅速 成 为 大 多 数 开 发 者 进行 
Android 开 发 的 首选 语言 。 在 Big Nerd Ranch， 所 有 的 应 用 开发 项 目 都 采 
用 Kotlin， 即 使 是 过 去 那些 大 量 使 用 Java 的 遗留 项 目 。 


转向 使 用 Kotlin 这 股 潮流 依然 浩荡 辐 前 。Android 框 架 团 队 已 开始 同 平 台 
遗留 代码 加 入 @nullable 注 解 。 他 们 不 断 发 布 用 于 Android 开 发 的 Kotlin 扩 
展 。 本 书 撰写 时 ，Google 正 忙于 向 Android 官 方 开发 文档 中 添加 Kotlin 示 
例 和 文 持 。 

Android 框 架 最 初 是 使 用 Java 开 发 的 ， 也 就 是 说 ， 你 用 到 的 大 部 分 
Android 类 是 用 Java 编 写 的 。 和 幸运 的 是 ，Kotlin 文 持 与 Java 互 操作 ， 所 以 
使 用 Kotlin 开 发 不 会 有 任何 问题 。 

本 书 选 择 使 用 Kotlin API， 即 使 这 些 API 背 后 的 开发 语言 是 Java。 无 论 你 
喜欢 Kotlin 还 是 Java， 本 书 传授 的 都 是 如 何 开 发 Android 应 用 。 你 所 学 的 
Android 平 台 上 的 开发 经 验 和 知识 ， 对 这 两 种 语言 都 适用 。 

如 何 使 用 本 书 

本 书 不 是 一 本 参考 书 。 我 们 的 目标 是 帮 你 跨越 学 习 的 初始 障碍 ， 进 而 充 
分 利用 其 他 参考 资料 和 实例 类 图 书 来 深入 学 习 。 本 书 基于 Big Nerd 
Ranch 培 训 机 构 的 五 天 教学 课程 编写 而 成 ， 从 基础 知识 讲 起 ， 各 章 内 容 
循序 渐进 ， 所 以 建议 不 要 跳 读 ， 以 免 学 习 效 果 大 打折 扣 。 


我 们 为 学 员 提 供 了 良好 的 培训 环境 : 专用 的 教室 、 可 口 的 美食 、 舒 适 的 
住 牡 条件、 动力 十 足 的 学 习 伙伴 ， 以 及 随时 答疑 解 惑 的 指导 老师 。 


作为 本 书 读者 ， 你 同样 需要 类 似 的 恨 好 环境 。 因 此 ， 你 需要 保证 充足 的 
睡 虑 ， 然 后 找 一 个 安静 的 地 方 开始 学 习 。 参 考 以 下 建议 也 很 有 帮助 。 


(1) 和 朋友 或 同事 组 成 阅读 小 组 。 
(2) 集中 安排 时 间 逐 章 学 习 。 
(3) 参与 本 书 论坛 的 交流 和 讨论 。 


(4) 向 Android 开 发 高 手 寻 求 帮助 。 
本 书 内 容 


本 书 会 种 你 学 习 开 发 七 个 Android 应 用 。 有 些 应 用 很 简单 ， 一 章 即 可 讲 
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排 的 应 用 ， 你 能 学 到 很 多 重要 的 理论 知识 和 开发 技巧 ， 并 获得 最 直接 的 
开发 经 验 。 


GeoQuiz 


本 书 中 的 第 一 个 应 用 ， 用 来 学 习 Android 应 用 的 基本 组 成 、 
activity、 界 面 布局 以 及 显 式 intent。 


CriminalIntent 

本 书 中 最 复杂 的 应 用 ， 能 够 记录 办 公 室 同事 的 种 种 陋习 ， 用 来 学 习 
fragment、1list-backed 用 户 界面 、 数 据 库 、 沫 单 选 项 、 相 机 调用 、 隐 
式 intent 等 内 容 。 

BeatBox 

一 个 可 以 吓 退 对 手 的 应 用 ， 用 来 学 习 媒 体 文件 的 播放 与 控制 、 
MVVM 架 构 、 数 据 绑 定 、 单 元 测试 、 主 题 以 及 drawable 资 源 。 
NerdLauncher 


一 个 个 性 化 局 动 器 ， 用 来 深入 学 习 intent、 进 程 以 及 Android 任 务 。 


PhotoGallery 


一 个 从 Flickr 网 站 下 载 照 片 并 进行 显示 的 客户 问 应 用 ， 用 来 学 习 后 
台 任 务 调度 、 多 线程 、 网 络 内 容 下 载 等 知识 。 


DragAndDraw 


一 个 简单 的 画图 应 用 ， 用 来 学 习 如 何 处 理 触摸 手势 事件 以 及 如 何 创 
建 个 性 化 视图 。 


e Sunset 
一 个 漂亮 的 日 沙 动 画 应 用 ， 用 来 学 习 Android 动 画 。 

挑战 练习 
大 部 分 草 末 配 有 练习 题 。 你 可 借 此 机 会 实践 所 和 学， 查阅 官 方 文档 ， 锻 炼 
独立 解决 问题 的 能 力 。 
强烈 建议 你 完成 这 些 挑 战 练习 。 在 练习 过 程 中 ， 不 妨 尝 试 男 放 踩 径 ， 这 
有 助 于 你 巩固 所 学 知识 ， 增 强 未 来 开发 应 用 的 信心。 
在 遇 到 一 时 难以 解决 的 问题 ， 请 访问 本 书 论坛 求助 。 
深入 学 习 


部 分 章 末 还 包含 "深入 学 习 * 一 节 。 这 一 节 对 该 章 内 容 进行 了 深入 讲解 或 
提供 了 更 多 信息 。 这 一 节 不 属于 必须 掌握 的 部 分 ， 但 希望 你 有 兴趣 阅读 
并 有 所 收获 。 


版 式 膏 明 
为 方便 阅读 ， 本 书 会 对 某 些 特 定 内 容 采 用 专门 的 字体 。 变 量 、 常 量 、 类 
型 、 类 名 、 接 口 名 和 函数 名 会 以 代码 体 显示 。 


所 有 代码 与 XML 清单 也 会 以 代码 体 显 示 。 需 要 输入 的 代码 或 XML 总 是 
以 粗 体 显 示 。 应 该 删除 的 代码 或 XML 会 打上 删除 线 。 例 如 ， 在 以 下 代 
码 里 ， 我 们 删除 了 Toast.makeText(...).show() 函 数 的 调用 ， 增 加 
J checkAnswer (true) eR ACA Val A 


trueButton.setOnClickListener { view: View -> 


checkAnswer (true) 


} 


Android} 4 


本 书 教学 主要 针对 当前 广泛 使 用 的 各 个 系统 版 本 (Android 5.0 至 
Android 11.0) 。 虽 然 更 老 的 系统 版 本 仍 有 人 在 用 ， 但 对 于 大 多 数 开 发 
者 来 说 ， 为 文 持 这 些 版 本 而 付出 努力 得 不 偿 失 。 


如 果 应 用 确实 需要 支持 Android 5.0 之 前 的 系统 版 本 ， 请 参考 本 书 第 3 版 
(Android 4.4 及 以 上 版 本 ) 、 第 2 版 (Android 4.1 及 以 上 版 本 ) 和 第 1 版 
(Android 2.3 及 以 上 版 本 ) 的 相关 内 容 。 


新 版 本 的 Android 系 统 还 会 不 断 发 布 。 请 放心 ，Android 支 持 同 后 兼容 
〈 详 见 第 7 章 ) ， 即 便 有 了 新 系统 ， 本 书 所 授 知 识 也 不 会 过 时 。 我 们 也 
x. ae Cee eee ded 问 ， 及 时 为 你 提供 开发 指导 
WC. 


N N 
JF A ILE 
开始 学 习 前 ， 你 需要 安装 Android Studio. Android Studio 基 于 流行 的 
IntelliJ IDEA 创 建 ， 是 一 套 Android 集 成 开发 工具 。 
Android Studio 的 安装 包括 如 下 内 容 。 
e Android SDK 


最 新 版 本 的 Android SDK. 


e Android SDK 工 具 和 平台 工具 


用 来 测试 与 调试 应 用 的 一 套 工具 。 


。 Android 模 拟 器 系统 镜像 
用 来 在 不 同 虚 拟 设备 上 开发 和 测试 应 用 。 
本 书 撰写 时 ，Android Studio 版 本 正在 积极 开发 和 更 新 中 。 因 此 ， 请 注意 
前 版 本 和 本 书 所 用 版 本 之 间 的 差异 。 如 需 帮助 ， 请 访问 本 书 论 
Android Studio 的 下 载 与 安装 
可 以 从 Android 开 发 者 网 站 下 载 Android Studio。 
goce 次 安装 ， 还 需 从 Oracle 官 网 下 载 并 安装 Java 开 发 工具 套件 


下 载 早 期 版 本 的 SDK 
Android Studio 自 带 最 新 版 本 的 SDK 和 模拟 器 系统 镜像 。 如 果 想 在 


Android 早 期 系统 版 本 上 测试 应 用 ， 还 需 额 外 下 载 相关 工具 组 件 。 


可 通过 Android SDK 管 理 器 来 安装 这 些 组 件 ， 如 图 0-1 所 示 。 在 Android 

Studio 中 ， 选 择 Tools > SDK Manager 菜 单项 。 (已 创建 并 打开 了 新 项 目 
时 ，Tools 荣 单 才 可 见 。 如 果 还 没 创建 过 项 目 ， 可 在 Android 开 发 向 导 界 
面 ， 选 择 Configure o SDK Manager 来 启动 SDK 管 理 器 。) 


0e 0 Preferences for New Projects 


Appearance & Behavior > System Settings > Android SDK 
Manager for the Android SOK and Tools used by Android Studio 


* Appearance & Behavior 
Appearance Android SDK Location: — JUsers/kmars/Library/Android/sdk Edit 
Minus a Toolbars SDK Platforms SDK Tools SDK Update Sites 
System Settings ae Rae 
Each Android SDK Platform package includes the Android platform and sources pertaining to an 
Passwords API level by default, Once installed, Android Studio will automatically check for updates. Check 
HTTP Proxy "show package details" to display individual SDK components. 
; Name API Level Revision Status 
SIEGE _} Android Q Preview Q 1 Not installed 
Updates Android 9.0 (Pie) 28 6 Installed 
C Android 8.1 (Oreo) 27 3 Partially installed 
Notifications |. Android 8.0 (Oreo) 26 2 Partially installed 
Quick lets | | Android 7.1.1 (Nougat) 25 3 Not installed 
.. Android 7.0 (Nougat) 24 2 Not installed 
Path Variables C Android 6.0 (Marshmallow) 23 3 Not installed 
Keymap |_ | Android 5.1 (Lollipop) 22 2 Not installed 
» Editor (_ Android 5.0 (Lollipop) 21 2 Not installed 
| | Android 4.4W (KitKat Wear) 20 2 Not installed 
Plugins 


7] Hide Obsolete Packages | | Show Package Details 
> Build, Execution, Deployment Hi ges U ge Detai 


? Cancel Apply 


图 0-1 Android SDK‘ JẸ Z& 


选择 并 安装 需要 的 Android 版 本 和 工具 。 下 载 这 些 组 件 需要 一 点 儿 时 


间 ， 请 耐心 等 待 。 


通过 Android SDK 管 理 器 ， 还 可 以 及 时 获取 Android 最 新 发 布 的 内 容 ， 比 
如 新 系统 平台 或 新 版 本 工具 等 。 


便 件 设备 


模拟 占 是 测试 应 用 的 好 帮手 ， 但 需 测 试 应 用 性 能 时 ，Android 物 理 设备 
无 可 蔡 代 。 如 果 手 头 有 物理 设备 ， 建 议 按 需 使 用 。 
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"B13Xi Android 开 发 初 体 验 


本 章 将 带 你 开 肥 本 书 第 一 个 应 用 ， 并 借 此 学 习 一 些 Android 基 本 概念 以 
及 构成 应 用 的 用 户 界面 〈UI) 部 件 。 学 完 本 章 ， 如 果 没 能 全 部 理解 ， 也 
不 必 担 心 ， 后 续 章 节 还 会 涉及 这 些 内 容 并 有 更 加 详细 的 讲解 。 


马上 要 开发 的 应 用 名 叫 GeoQuiz， 它 能 提出 一 道道 地 理 知 识 问题 。 用 户 
点 击 TRUE 或 FALSE 按 钮 来 回答 屏幕 上 的 问题 ，GeoQuiz 会 即时 做 出 反 


"B. 
馈 。 


图 1-1 显 示 了 用 户 点 击 TRUE 按 钮 的 结果 。 


9:00 Wie. b 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


Correct! 


图 1-1 你 是 澳洲 人 吗 


1.1 Android 开 发 基础 
GeoQuiz 应 用 由 一 个 activity 和 一 个 布局 (layout) 组 成 。 


。 activity 是 Android SDK 中 Activity 类 的 一 个 实例 ， 负 责 管理 用 户 与 
应 用 界面 的 交互 。 


MARIZA sea ie are bh See 对 于 简单 的 应 用 来 
说 ， 一 个 Activity 子 类 可 能 就 够 了 了， 而 复杂 的 应 用 会 有 多 
个 Activity 子 类 。 


GeoQuiz 是 个 简单 应 用 ， 已 只 有 一 个 名 叫 MainActivity 的 
Activity 子 类 。MainActivity 管 理 着 图 1-1 所 示 的 用 户 界面 。 


布局 定义 了 一 系列 UI 对 象 以 及 它们 显示 在 屏幕 上 的 位 置 。 组 成 布局 
的 定义 保存 在 XML 文件 中 。 每 个 定义 用 来 创建 屏幕 上 的 一 个 对 
象 ， 比 如 按钮 或 文本 信息 。 


GeoQnuiz 应 用 包含 一 个 名 叫 activity_main.xml 的 布局 文件 。 该 布局 文 
件 中 的 XML 标签 定义 了 图 1-1 所 示 的 用 户 界 面 。 


MainActivity 与 activity_main.xml 文 件 的 关系 如 图 1-2 所 示 。 


MainActivity 


图 1-2 MainActivity 管 理 着 activity_main.xml 定 义 的 用 户 界 面 
有 了 这 些 Android 基 本 概念 之 后 ， 我 们 来 创建 GeoQuiz 应 用 。 


1.2 创建 Android 项 目 


首先 我 们 创建 一 个 Android 项 目 。Android 项 目 包 含 组 成 一 个 应 用 的 全 部 
文件 。 


启动 Android Studio 程 序 。 如 果 是 首次 运行 ， 会 看 到 如 图 1-3 所 示 的 欢迎 


界 


eo Welcome to Android Studio 


m 


Android Studio 


Version 3.3.1 


十 Start a new Android Studio project 

x Open an existing Android Studio project 
lf Check out project from Version Control ~ 
[€ Profile or debug APK 

L Import project (Gradle, Eclipse ADT, etc.) 


pf Import an Android code sample 


XX Configure Get Help ~ 


图 1-3 ”欢迎 使 用 Android Studio 


创建 新 项 目 之 前 ， 请 先 关 闭 Android Studio 的 Instant Run 功 能 。 这 项 功能 
的 设计 初衷 是 提高 开发 效率 。 代 码 修 改 后 ， 无 须 生 成 新 APK， 开 发 人 员 
束 能 立即 看 到 变化 。 不 过 ， 很 可 惜 ， 它 的 实际 表现 不 及 预期 ， 因 此 建议 
一 开始 束 彻 底 禁 用 这 一 功能 。 


在 欢迎 界面 的 底部 ， 点 击 Configure， 再 选择 Settings， 会 弹出 如 图 1-4 所 
示 的 新 项 目 首选 项 界面 。 展 开 左 边 的 Build, Execution, Deployment 选 项 
并 选中 Instant Run， 取 消 勾 选 Enable Instant Run to hot swap code/resource 
changes on deploy (default enabled)， 然 后 点 击 OK 按 钮 。 


000 Preferences for New Projects 


Qy Build, Execution, Deployment + Instant Run Reset 


Instant Run requires the project to be built with Gradle. 
Keymap 


" [] Enable Instant Run to hot swap code/resource changes on deploy (default enabled) 
» Editor 


v Restart activity on code changes 
Plugins 


» Version Control 

* Build, Execution, Deployment 
> Build Tools 
> Compiler 


¥ Show toasts in the running app when changes are applied 


- | Show Instant Run status notifications 


> Debugger 

Remote Jar Repositories 
Compiler 
Coverage 
Espresso Test Recorder 
Required Plugins 

» Languages & Frameworks 

* Tools 


U | Cancel || Apply | 


图 1-4 ”新 项 目 首选 项 


(如 果 之 前 用 过 Android Studio 工 具 ， 看 不 到 欢迎 界面 的 话 ， 可 以 通过 选 
择 Android Studio 5 Preferences 菜 单项 ， 然 后 扩展 Build, Execution, 
Deployment 选 项 并 继续 上 面 的 操作 。) 


回 到 欢迎 界面 ， 选 择 创建 新 项 目 选 项 (Start a new Android Studio 
project) ; 如 果 并 非 首次 运行 Android Studio， 请 选择 File > New > 
New Project... 荣 单项 。 


现在 ， 你 应 该 打开 了 新 建 项 目 同 导 界面 ， 如 图 1-5 所 示 。 确 认 选 中 Phone 
and Tablet 选 项 页 和 Empty Activity， 然 后 点 击 Next 按 钮 继续 。 


@08 Create New project 


Choose your project 


Phone and Tablet — WearOS TV Android Auto Android Things 


Add No Activity 


Basic Activity Empty Activity Bottom Navigation Activity | 


\ a 
A 


^" 
Re 


Fullscreen Activity Master/Detail Flow Navigation Drawer Activity Google Maps Activity 


Empty Activity 
Creates a new empty activity 


Cancel Previous Next | Finish | 


图 1-5 选择 项 目 模板 


配置 项 目 窗口 弹出 了 。 在 此 界面 的 应 用 名 称 (Name) 处 输入 GeoQnuiz。 
在 包 名 (Package name) 处 输入 com.bignerdranch.android.geoquiz。 至 于 
项 目 存储 位 置 (Save location) ， 了 吏 看 个 人 喜好 了 。 接 下 来 开发 语言 选 
Kotlin，SDK 最 低 版 本 选 API 21: Android 5.0 (Lollipop)。 第 7 章 会 介绍 
Android 不 同 SDK 版 本 的 差异 。 最 后 ， 勾 选 Use AndroidX artifacts, FEK 
后 的 界面 如 图 1-6 所 示 。 


@ce Create New Projact 


Configure your project 


Name 


GeoQuiz 


Package name 


com.bignerdranch.android.geoquiz 


Save location 


{Users/ieremy/AndroidStudioProjects/GeoQuiz 


Language 


Pre ] 
| Kotlin Y | 


Minimum API level 


Empty Activity AP 21; Android 5.0 (Lollipop) d 


© Your app will run on approximately 85.0% of devices. 
Help me choose 
_ ] This project wil support instant apps 


Use AndroidX artifacts 
Creates a new empty activity 


| Cancel | | Previous | Next 


图 1-6 配置 新 项 目 


注意 ， 以 上 包 名 遵循 了 “DNS 反 转 ”约定 ， 也 就 是 将 组 织 或 公司 的 域名 反 
转 后 ， 在 尾部 附加 上 应 用 名 称 。 遵 循 此 约定 可 以 保证 包 名 的 唯一 性 ， 这 
样 ， 同 一 设备 和 Google Play 商店 的 各 类 应 用 束 可 以 区 分 开 来 。 


本 书 撰写 时 ，Android Studio 新 建 项 目 默认 使 用 Java 语 言 。 选 Kotlin 是 让 
Android Studio 准 备 好 该 语言 相关 的 各 种 工具 和 依赖 ， 以 便 编 写 和 构建 
Kotlin H o 


一 直 以 来 ，Java 是 Android 开 发 唯一 的 官方 支持 语言 ， 直 到 2017 年 5 月 ， 

Android 开 发 团队 在 Google IO 大 会 上 宣布 Kotlin 为 Android 开 发 又 一 官方 
支持 语言 。 如 今 ， 包 括 我 们 在 内 ，Kotlin 已 成 为 大 多 数 开 发 人 员 的 首选 
语言 。 如 果 你 的 项 目 依然 选用 Java 也 没关系 ， 本 书 所 教 概念 和 内 容 同样 


适用 


过 去 ，Google 一 直 维 护 着 庞大 的 支持 库 ， 用 来 协助 开发 和 人 解决 兼容 性 问 
题 。 作 为 改进 ，AndroidX 将 这 个 巨型 库 拆 分 为 一 个 个 独立 的 开发 和 版 本 
库 ， 统 称 为 Jetpack。 色 选 Use AndroidX artifacts 就 是 让 新 项 目 能 用 上 这 

些 独 立 工具 库 。 第 4 章 将 详细 介绍 AndroidX 和 Jetpack， 本 书 中 会 用 到 各 

种 各 样 的 Jetpack 库 。 


(Android Studio 更 新 频 和 楷 ， 因 此 新 版 本 的 问 导 界面 可 能 与 本 书 略 有 不 

同 。 这 不 是 什么 大 问题 ， 一 般 来 讲 ， 工 具 更 新 后 ， 回 导 界 面 的 配置 选项 
应 该 不 会 有 太 大 差别 。 如 果 大 有 不 同 ， 说 明 开 发 工具 有 了 重大 更 新 。 不 
要 担心 ， 请 访问 本 书 论 坛 ， 我 们 会 教 你 如 何 使 用 新 版 本 的 开发 工具 。) 


点 击 Finish 按 钮 ，Android Studio 会 完成 创建 并 打开 新 项 目 。 


1.3 Android Studio 使 用 导航 


如 图 1-7 所 示 ，Android Studio 已 在 工作 区 窗口 里 打开 新 建 项 目 。 如 果 并 
非 首次 运行 Android Studio， 你 看 到 的 窗口 配置 可 能 稍 有 不 同 。 
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D) Gradle bulki finished in 821 ms (moments ago) 


图 1-7 新 的 项 目 窗 口 


P deti 


e |) Coet: ege ag 


整个 工作 区 窗口 分 为 不 同 的 区 域 ， 这 里 统称 为 工具 窗口 〈tool 


window) 。 


左边 是 项 目 工 具 窗口 (project tool window) ， 通 过 它 可 以 查看 和 管理 所 
有 与 项 目 相 关 的 文件 。 


工作 区 底部 是 构建 工具 窗口 (build tool window) ， 可 以 在 这 里 看 到 项 
目的 编译 过 程 和 构建 状态 。 新 建 项 目 时 ，Android Studio 会 上 自动 进行 项 目 
构建 。 可 以 看 到 ， 构 建 工 具 窗 口 显示 构建 已 成 功 完成 。 


在 项 目 工具 窗口 中 ， 点 击 app 和 旁边 的 展开 箭头 ，Android Studio 会 自动 打 
开 activity_main.xml 和 MainActivity.kt 文 件 。 如 图 1-8 所 示 ， 打 开 文 件 所 在 
的 区 域 叫 编辑 工具 窗口 Ceditor tool window) ， 或 直接 叫 代码 编辑 区 

Ceditor) 。 依 然 要 提醒 的 是 ， 如 果 并 非 首 次 运行 Android Studio, {th 
编辑 区 会 自动 打开 所 建 项 目 文件 。 
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图 1-8 ”编辑 工具 窗口 


注意 Activity 类 名 的 前 级 ， 此 前 级 不 加 也 可 以 ,但 这 是 个 很 好 的 命名 
AVE, ENAT. 


点 击 工作 区 窗口 左边 、 右 边 以 及 底部 标 有 各 种 名 称 的 工具 按钮 区 域 ， 可 
显示 或 隐藏 各 类 工具 窗口 。 当 然 ， 也 可 以 直接 使 用 它们 对 应 的 快捷 键 。 
如 果 看 不 到 某 个 工具 按钮 ， 可 以 点 击 左 下 角 的 灰色 方形 区 域 或 点 击 View 
5 Tool Buttons 菜 单项 找到 它 。 


1.4 用 户 界 面 设计 


点 击 activity_main.xml 布 局 文件 页 ， 会 在 编辑 工具 窗口 打开 布局 编辑 
器 ， 如 图 1-9 所 示 。 如 果 看 不 到 布局 文件 ， 请 在 项 目 工具 窗口 展开 
app/res/layout/ 找 到 它 并 双击 打开 。 如 果 看 到 的 是 activity_main.xml 文 件 
的 XML 代码 ， 请 点 击 底部 的 Design 页 ， 切 换 显 示 布 局 预览 。 
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图 1-9 布局 编辑 器 
按照 约定 ， 布 局 文件 的 命 
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Hello Word! 


六 名 基于 其 关联 的 activity: activity_ 作 为 前 绥 ， 


activity 子 类 名 的 其 余部 分 全 部 转 小 写 并 紧 随 其 后 ， 单 词 之 间 以 下 划 线 隔 
开 。 例 如 ， 当 前 新 建 项 目的 布局 文件 名 为 activity_main.xml， 或 者 说 你 
有 个 activity 名 为 SplashscreenActivity， 那 么 对 应 的 布局 就 命名 为 
activity_splash_screen。 对 于 后 续 章 节 中 的 所 有 布局 以 及 将 要 学 习 的 其 他 
资源 ， 都 建议 采用 这 种 命名 风格 。 


布局 编辑 器 展示 的 是 文件 的 图 形 化 预览 界面 ， 你 可 以 点 击 底部 的 Text 页 
切换 显示 布局 的 XML 代码 。 


当前 ，activity_main.xml 文 件 定 义 了 默认 的 activity 布 局 。 默 认 的 XML 布 
局 文件 内 容 经 党 有 变 ， 但 相 比 代 码 清单 1-1， 一 般 不 会 有 很 大 出 入 。 


代码 清单 1-1 默认 的 activity 布 局 Cres/layout/activity main.xml) 


<?xml version-"1.0" encoding-"utf-8"?» 

«androidx.constraintlayout.widget.ConstraintLayout 
xmlns:android-z"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
xmlns:app="http://schemas. android. com/apk/res-auto" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
tools:context-".MainActivity"» 


«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Hello World!" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintLeft toLeftOf-"parent" 
app:layout constraintRight toRightOf-"parent" 
app:layout constraintTop toTopOf-"parent"/» 


«/androidx.constraintlayout.widget.ConstraintLayout» 


应 用 activity 的 默认 布局 定义 了 两 个 视图 (view) : ConstraintLayout 
和 TextView。 


视图 是 用 户 界 面 的 构造 模块 。 显 示 在 屏幕 上 的 一 切 都 是 视图 。 用 户 能 
到 并 与 之 交互 的 视图 称 为 部 件 Cwidget) 。 有 些 部 件 可 以 用 来 显示 文字 
或 图 像 ， 有 些 部 件 〈 比 如 按钮 ) 可 以 点 击 以 触发 事件 任务 。 


Android SDK 内 置 了 多 种 部 件 ， 通 过 配置 各 种 部 件 可 获得 应 用 所 需 的 外 


观 及 行为 。 每 一 个 部 件 都 是 View 类 或 其 子 类 〈 比 如 TextView 
或 Button) 的 一 个 具体 实例 。 


我 们 得 想 办 法 告 A Ne Sl as ViewGroup 就 是 这 样 
一 种 特殊 的 View， 它 它 包 含 并 布置 其 他 视图 。 Vo 
p 蔬 规 划 其 他 视图 内 容 应 该 显示 在 哪里 。ViewGroup 通 常 又 称 为 布 


在 当前 默认 布局 里 ，ConstraintLayout 这 个 ViewGroup 布 置 了 一 
个 TextView 部 件 ， 这 是 它 唯 一 的 子 部 件 。 有 关 布 局 和 部 件 的 知识 ， 以 
及 如 何 使 用 ConstraintLayout， 第 10 章 将 详 述 


图 1-10 展 示 了 代码 清单 1-1 中 定义 的 ConstraintLayout 和 TextView 是 
如 何在 屏幕 上 显示 的 。 
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图 1-10 ”显示 在 屏幕 上 的 默认 视图 
不 过 ， 图 1-10 所 示 的 默认 部 件 并 不 是 我 们 需要 的 ，MainActivity 的 用 


户 界面 需要 以 下 五 个 部 件 : 


e 一 个 垂直 LinearLayout 部 件 ; 
e 一 个 TextView 部 件 ; 
e 一 个 水 平 LinearLayout 部 件 ; 
。 两 个 Button 部 件 。 
图 1-11 展 示 了 以 上 部 件 是 如 何 构成 MainActivity 用 户 界面 的 。 
—— 
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图 1-11 布置 并 显示 在 屏幕 上 的 部 件 


下 面 我 们 在 布局 XML 文 件 中 定义 这 些 部 件 。 对 照 代码 清单 1-2， 修 改 
activity_main.xml 文 件 内 容 。 注 意 ， 需 删除 的 XML 代码 已 打上 删除 线 ， 
需 添 加 的 XML 以 粗 体 显示 。 本 书 统一 使 用 这 样 的 代码 增删 处 理 模 式 。 


代码 清单 1-2 在 XML 文件 中 定义 部 件 


(res/layout/activity_main.xml ) 


后 TE ER ETELE eee eR 


«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: gravity="center" 
android:orientation="vertical" > 


<TextView 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: padding="24dp" 
android: text="@string/question_text" /> 


<LinearLayout 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: orientation="horizontal" > 


<Button 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:text-"gstring/true button" /> 


«Button 
android:layout width-z"wrap content" 
android:layout height-"wrap content" 
android:text-"Qgstring/false button" /> 


</LinearLayout> 


</LinearLayout> 


参照 代码 清单 输入 代码 ， 暂 时 不 理解 这 些 代 码 也 没关系 ， 你 会 在 后 续 学 
习 中 逐渐 和 弄 明白 的 。 注 意 ， 开 发 工具 无 法 校 验 布局 XML 内容， 拼写 错 
误 早晚 会 出 问题 ， 应 尽量 避免 。 


可 以 看 到 ， 有 三 行 以 android:text 开 头 的 代码 出 现 了 错误 信息 。 和 暂时 
忽略 它们 ， 稍 后 会 处 理 。 


对 照 图 1-11 所 示 的 用 户 界 面 得 看 XML 文件 ， 可 以 看 出 部 件 与 XML 元 素 
一 一 对 应 。 元 素 名 称 就 是 部 件 的 类 型 。 


各 元 系 均 有 一 组 XML 属性 。 属 性 可 以 看 作 关 于 如 何 配置 部 件 的 指令 。 
为 方便 理解 元 系 与 属性 的 工作 原理 ， 接 下 来 我 们 将 以 层级 视角 来 研究 布 
局 。 


1.4.1 视图 层级 结构 


部 件 包含 在 视图 对 象 的 层级 结构 中 ， 这 种 结构 又 称 作 视图 层级 结构 
(view hierarchy) 。 图 1-12 展 示 了 代码 清单 1-2 所 示 的 XML 布局 对 应 的 
视图 层级 结构 。 


LinearLayout 


xmlns:android="http://schemas android, com/apk/res/android" 
android: Layout, widthz match, parent" 

android: layout, heightz" match, parent" 

android: gravity- center" 

android: orientation- vertical 


TextView , 

| | LinearLayout 

android: layout, width wrap, content" 

| i android: layout_width="wrap_content" 
android; layout, heightz" irap, content" | 

| android: layout, heightz" rap content" 
android: padding="24dp" ners | 

android: orientation-" horizontal" 


android: text="(@string/question_text" 


Button Button 
android: Layout_width="wrap content" android: layout widthz wrap content" 
android:layout heightz"wrep content"| — |android:layout heightz"wrap content" 


android: textz get ring/true, button" android: text="@string/false_button" 


图 1-12 布局 部 件 的 层级 结构 


从 布局 的 视图 层级 结构 可 以 看 到 ， 其 根 元 素 是 一 个 LinearLayout 部 
件 。 作 为 根 元 素 ，LinearLayout 部 件 必须 指定 Android XML 资源 文件 
的 命名 空间 属性 。 


LinearLayout 部 件 继承 自 ViewGroup 部 件 (也 是 一 个 View 子 

类 ) 。ViewGroup 部 件 是 包含 并 布置 其 他 视图 的 特殊 视图 。 想 要 以 一 列 
或 一 排 的 样式 布置 部 件 ， 就 可 以 使 用 LinearLayout 部 件 。 其 他 
ViewGroup 子 类 还 有 ConstraintLayout 和 FrameLayout。 


如 果菜 个 视图 包含 在 一 个 ViewGroup 中 ， 该 视图 与 ViewGroup 即 构成 父 
子 关 系 。 根 LinearLayout 有 两 个 子 部 件 : TextView 和 为 一 

个 LinearLayout。 作 为 子 部 件 的 LinearLayout 自 己 还 有 两 个 Button 
子 部 件 。 

1.4.2 ”部 件 属 性 

下 面 来 看 看 配置 部 件 时 常用 的 一 些 属性 。 


01. android:layout _width 和 android:1layout_height 属 性 


几乎 每 类 部 件 都 需要 android:1ayout_width 和 
android:1layout_height 属 性 。 以 下 是 它们 的 两 个 常见 属性 值 
(Sea 


e match parent: 视图 与 其 父 视图 大 小 相同 。 
e wrap content: 视图 将 根据 其 显示 内 容 自动 调整 大 小 。 


根 LinearLayout 部 件 的 高 度 与 宽度 属性 值 均 
为 match_parent。LinearLayout 虽 然 是 根 元 素 ， 但 它 也 有 父 视图 
Android 提 供 该 父 视图 来 容纳 应 用 的 整个 视图 层级 结构 。 


其 他 包含 在 界面 布局 中 的 部 件 ， 其 高 度 与 宽度 属性 值 均 被 设置 
为 wrap_content。 请 参照 图 1-11 理 解 该 属性 值 定义 尺寸 大 小 的 作 
H. 


TextView 部 件 比 其 包含 的 文字 内 容 区 域 稍 大 一 些 ， 这 主要 
是 android:padding="24dp" (dpEldensity-independent pixel， 指 
与 密度 无 关 的 像素 ， 详 见 第 10 章 ) 属性 的 作用 。 访 属性 告诉 部 件 在 


决定 大 小 时 ， 除 内 容 本 映 外 ， 还 需 增 加 额外 指定 量 的 空间 。 这 样 屏 
2 的 问题 与 按钮 之 间 便 会 留 有 一 定 的 空间 ， 使 整体 显得 更 为 
Xie 


02. android:orientation/&/lt 


android:orientation 属 性 是 两 个 LinearLayout 部 件 都 具有 的 属 
性 ， 它 决定 两 者 的 子 部 件 是 水 平 放置 还 是 垂直 放置 。 
根 LinearLayout 是 垂直 的 ， 子 LinearLayout 是 水 平 的 。 


子 部 件 的 定义 顺序 决定 其 在 屏幕 上 显示 的 顺序 。 在 垂直 的 
LinearLayout 中 ， 第 一 个 定义 的 子 部 件 出 现在 屏幕 的 最 上 端 ; 而 
在 水 平 的 LinearLayout 中 ， 第 一 个 定义 的 子 部 件 出 现在 屏幕 的 最 
Emo 如 果 设 备 文 字 从 右 至 左 显示 ， 比 如 阿拉 伯 语 或 者 希 伯 来 
语 ， 则 第 一 个 定义 的 子 部 件 出 现在 屏幕 的 最 右 端 。 ) 


03. android :text 属 性 


TextView 与 Button 部 件 具有 android:text 属 性 。 该 属性 指定 部 
件 要 显示 的 文字 内 容 。 


请 注意 ，android:text 属 性 值 不 是 字符 串 值 ， 而 是 以 @string/ 语 
法 形式 对 字符 串 资源 (string resource) 的 引用 。 


字符 串 资 源 包含 在 一 个 独立 的 名 叫 strings 的 XML 文件 中 
(strings.xml) ， 虽 然 可 以 硬 编码 设置 部 件 的 文本 属性 值 ， 比 如 
android:text="True"， 但 这 通常 不 是 个 好 办 法 。 比 较 好 的 做 法 
是 将 文字 内 容 放 置 在 独立 的 字符 串 资源 XML 文 件 中 ， 然 后 引用 它 

们 。 这 样 会 方便 应 用 的 本 地 化 《〈 详 见 第 17 章 ) 。 


需要 在 activity_main.xml 文 件 中 引用 的 字符 串 资 源 还 没 添加 ， 现 在 
就 来 处 理 。 


1.4.3 ”创建 字符 串 资源 


每 个 项 目 都 包含 一 个 默认 字符 串 资 源 文 件 res/values/strings.xml。 


打开 res/values/strings， xml 文 件 ， 可 以 看 到 ， 项 目 模板 已 经 添加 了 一 个 字 
符 串 资源 。 如 代码 清单 1-3 所 示 ， 添 加 应 用 布局 需要 的 三 个 新 字符 串 。 


代码 清单 1-3 ”添加 字符 串 资 源 Cres/values/strings.xml ) 


<resources> 
<string name="app_name">GeoQuiz</string> 
<string name="question_text">Canberra is the capital of Australia.</str 


<string name="true_button">True</string> 
«string name="false_button">False</string> 
</resources> 


3 


(Android Studio 某 些 版 本 的 strings.xml 默 认 带 有 其 他 字符 吕 ， 这 些 字 名 
串 可 能 与 其 他 文件 有 关联 ， 请 勿 随意 删除 。) 


现在 ， 在 GeoQuiz 项 目的 任何 XML 文件 中 ， 只 要 引用 
到 @string/false_button， 应 用 运行 时 ， 就 会 得 到 “False” 文 本 。 


人 这 时 ，activity_main.xml 布 局 缺少 字符 串 资源 的 提 
示 信 息 o e (如 仍 有 错误 提示 ， 请 检查 一 下 这 两 个 文件 ， 确 认 
没有 拼写 错误 。 


默认 的 字符 串 文 件 虽 然 已 命名 为 strings.xml， 但 你 仍 可 以 按 个 人 喜好 重 
新 命名 。 一 个 项 目 也 可 以 有 多 个 字符 串 文 件 。 只 要 这 些 文件 都 放 在 
res/values/ 目 录 下 ， 含 有 一 个 resources 根 元 素 ， 以 及 多 个 string 子 元 
素 ， 应 用 就 能 找到 并 正确 使 用 它们 。 


1.4.4 PRA j 
至 此 ， 应 用 的 界面 布局 已 经 完成 ， 可 以 使 用 图 形 布局 工具 实时 预览 了 。 


回 到 activity_main.xml 文 件 ， 在 编辑 器 工具 窗口 的 底部 点 击 Design 页 进行 
布局 预览 ， 绪 果 如 网 1-13 上 所 示 。 


@~ GS O Pixely æ 287 ( AppTheme- © Default (en-us) v Qaam 由 国 A 
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图 1-13 ”在 Design 页 预览 activity_main.xml 布 局 


图 1-13 展 示 了 两 种 布局 预览 醒 怀 。 在 工具 栏 直上 角 ， 有 个 钻石 按钮 ， 我 
们 可 以 通过 它 的 下 拉 荣 单 切换 显示 不 同 的 布局 预览 模 设 
(Design) 预览 或 蓝图 (Blueprint) 预览 ， 或 者 并 排 显 示 设 计 预 览 和 蓝 
RIT o 


在 图 1-13 中 ， 左 边 是 设计 预览 模式 ， 用 来 展示 布局 在 设备 上 的 效果 ， 也 
包括 主题 样式 ; 右边 是 更 图 预 欠 模式 ， 用 来 展示 部 件 的 尺寸 以 及 它们 之 
间 的 位 置 关系 。 


在 设计 预 宽 模 式 下 ， 你 还 可 以 伍 看 布 局 在 不 同 的 设备 配置 下 的 拜耳。 
过 预览 窗口 上 方 的 面板 ， 可 以 指定 设备 类 型 、Android 模 拟 器 版 本 、 
mE 题 以 及 没 各 使 用 区 域 ， 碍 看 布局 的 不 同 泻 染 结果 。 你 甚 全 可 ui 


东 个 语言 区 域 的 目 右 到 左 的 文字 显示 模式 。 


除了 预 急 ， 你 也 可 以 直接 使 用 布局 编辑 器 摆 放 部 件 ， 布 置 布 局 。 如 图 1- 
14 所 示 ， 项 目 窗 口 左 边 有 个 面板 ， 包 括 了 Android 所 有 的 内 置 部 件 。 你 
可 以 将 它们 从 面板 拖 忠 到 视图 上 ， 或 者 拖 到 左下 方 的 部 件 树 上 ， 更 精准 
地 控制 如 何 摆 放 部 件 。 
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图 1-14 ”图 形 化 布局 编辑 器 


图 1-14 展 示 了 带 布局 装饰 (layout decoration) 的 布局 预览 。 这 些 装饰 元 
素 有 设备 状态 栏 、 带 GeoQuiz 标 签 的 应 用 栏 ， 以 及 虚拟 设备 按钮 栏 。 要 
添加 这 些 装 饰 ， 点 击 预览 窗口 上 方 工具 栏 中 的 眼睛 图 标 ， 选 择 Show 
Layout Decorations 3i Ff Jji B] n] Ț 


图 形 化 布局 编辑 器 非常 有 用 ， 尤 其 是 在 使 用 ConstraintLayout 时 ， 后 
面 学 习 第 10 章 内 容 时 ， 你 将 有 所 体会 。 


1.5 从 布局 XML 到 视图 对 象 


知道 activity_main.xzml 中 的 XML 元 素 是 如 何 转换 为 视图 对 象 的 吗 ? 答案 
就 在 于 MainActivity 类 。 


在 创建 GeoQuiz 项 目的 同时 ， 同 导 也 创建 了 一 个 名 为 MainActivity 的 
Activity 子 类 。MainActivity 类 文件 存放 在 项 目的 app/java 目 录 下 。 


继续 学 习 之 前 ， 束 appy/java 这 个 目录 名 问题 ， 简 单 说 两 句 : 这 里 依然 使 
用 java 作 为 目录 名 是 因为 Android 之 前 仪 支持 Java 语 言 。 新 建 项 目 时 ， 我 
们 虽然 选 了 Kotlin 语 言 〈 不 过 Kotlin 可 以 和 Java 完 全 互 操作 ) ， 但 Kotlin 
源码 默认 还 是 放 在 java 目 录 里 。 当 然 ， 你 完全 可 以 新 建 一 个 Kotlin 目 

录 ， 把 Kotlin 代 码 文 件 都 移 过 去 。 但 前 提 是 ， 你 要 明确 告诉 Android 
Studio: 源码 放 在 新 文件 夹 里 了 ， 请 帮 它 们 添加 到 项 目 里 。 大 多 数 情况 
下 ， 按 语言 区 分 管理 源码 文件 意义 不 大 ， 所 以 绝 大 多 数 项 目 接受 Kotlin 
文件 存放 在 java 目 录 里 。 


MainActivity.kt 文 件 应 该 已 经 在 编辑 器 窗口 打开 了 ， 如 果 没 有 ， 在 项 目 
工具 窗口 中 ， 依 次 展开 app/java 目 录 与 com.bignerdranch.android.geoquiz 
包 。【〔 注 意 ， 以 灰 绿 色 显 示 包 名 的 是 测试 包 。 生 产 包 名 并 未 加 灰 。) dX 
到 并 打开 MainActivity.kt 文 件 ， 碍 看 其 中 的 代码 ， 如 代码 清单 1-4 所 示 。 


代码 清单 1-4 默认 MainActivity 类 文件 (MainActivity.kt) 


package com.bignerdranch.android.geoquiz 


import androidx.appcompat.app.AppCompatActivity 
import android.os.Bundle 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


} 


} 


(是 不 是 不 明白 AppCompatActivity 的 作用 ? 它 实 际 就 是 一 
个 Activity 子 类 ， 能 为 Android 旧 上 厂 本 系统 提供 兼容 文 持 。 第 14 章 会 详 
细 介 绍 AppCompatActivity。 ) 


如 果 无 法 看 到 全 部 类 包 导 入 语句 ， 请 点 击 第 一 行 导 入 语句 左边 的 + 号 来 


显示 它们 。 


该 类 文件 有 一 个 Activity 函 数 : onCreate(Bundle?). 


activity 子 类 的 实例 创建 后 ，onCreate(Bundle? ) 函数 会 被 调用 。 
activity 创 建 后 ， 它 需要 获取 并 管理 用 户 界面 。 要 获取 activity 的 用 户 界 
面 ， 可 以 调用 以 下 Activity 函 数 : 


Activity.setContentView(layoutResID: Int) 


根据 传 入 的 布局 资源 ID 参数 ， 该 函数 生成 指定 布局 的 视图 并 将 其 放置 在 
屏 右 上 。 布 局 视图 生成 后 ， 布 局 文件 包含 的 部 件 也 随 之 以 各 目的 属性 定 
义 完成 实例 化 。 


资源 与 资源 ID 
布局 是 一 种 资源 。 资 源 是 应 用 非 代码 形式 的 内 容 ， 比 如 图 像 文件 、 音 频 
文件 以 及 XML 文件 等 。 


项 目的 所 有 资源 文件 都 存放 在 目录 app/res 的 子 目 录 下 。 在 项 目 工具 窗口 
中 可 以 看 到 ，activity_main.xml 布 局 资源 文件 存放 在 res/layout/ 目 录 下 。 
strings.xml 字 符 串 资源 文件 存放 在 res/values/ 目 录 下 。 


可 以 使 用 资源 ID 在 代码 中 获取 相应 的 资源 。activity_main.xml 布 局 的 资 
JSIDZJR.layout.activity main. 


查看 GeoQuiz 应 用 的 资源 ID 需要 切换 项 目 视角 ， 你 必须 勇 问 目 动 生成 代 
码 的 世界 一 一 Android 构 建 工 具 为 你 编写 的 代码 。 首 先 ， 点 击 Android 


Studio 窗 口 顶部 工具 栏 上 的 锤子 按钮 运行 编译 工具 。 


如 图 1-15 所 示 ，Android Studio 默 认 使 用 Android 项 目 视 角 。 为 让 开发 者 
专注 于 最 溃 用 的 文件 和 目录 ， 默 认 项 目 视角 隐藏 了 Android 项 目的 真实 
文件 目录 结构 。 在 项 目 工具 窗口 的 最 上 部 找到 下 拉 沈 单 ， 从 Android 视 
ee 。 Project 视 角 会 显示 出 当前 项 目的 所 有 文件 和 目 


Android © 0z20- i Project v 8z 刚 - 
hm Y fy GeoQuiz ~/writing/android/book/tfFirstApp/solution/GeoQuiz 
> Dy manifests > D gradle 
' jaa D idea 
combignerdranch android. geoquie gp | 
G MainActivity » D buid 
combignerdranch android.geoquiz (androidTest) , n gradie 
tx eombignerdranch.android.geoquiz (tes!) 2 ,Qitignore 
^ generatedJava A build.gradle 
^ ieres a GeoQuiz im) 
> a Gradle Scripts xi gradle properties 
$ gradlew 
= oradiew.bat 
local properties 
A settings.gradle 
> External Libraries 
Scratches and Consoles 


图 1-15 项 目 工具 窗口 : Android 视 角 与 Project 视 角 
在 Project 视 角 下 ， 逐 级 展开 GeoQuiz 目 录 ， 直 至 看 到 


GeoQuiz/app/build/generated/not_namespaced_r_class_sources/debug/proces: 


再 找到 项 目 包 名 以 及 其 中 的 R.java 文 件 ， 如 图 1-16 所 示 。 


司 Project ~ oOIÍl *€X— 
m= GeoQuiz -/writing/android/book/tfFirstApp/solution/GeoQuiz 
有 .gradle 
.idea 
zapp 
build 
generated 
Bs not_namespaced_r_class_sources 
Ba debug 
Ba processDebugResources 
bar 
Ba androidx 
Bu com 
Ba bignerdranch 
android 
Ba geoquiz 
renderscript_source_output_dir 


rac 


图 1-16 ”查看 R.java 文 件 


双击 打开 R.java 文 件 。 它 是 在 Android 项 目 编译 过 程 中 自动 生成 的 ， 所 以 
如 该 文件 头 部 的 警示 所 述 ， 请 不 要 修改 该 文件 的 内 容 ， 如 代码 清单 1-5 


所 示 。 
代码 清单 15 GeoQuiz 应 用 当前 的 资源 ID (R.java) 


/* AUTO-GENERATED FILE. DO NOT MODIFY. 


* This class was automatically generated by the 
* aapt tool from the resource data it found. It 
* should not be modified by hand. 


package com.bignerdranch. android. geoquiz; 


public final class R { 
public static final class anim { 


) 


public static final class id ( 


} 
public static final class layout { 


public static final Int activity main-0x7f030017; 
} 
public static final class mipmap { 

public static final Int ic launcherz0x7f030000; 
} 


public static final class string { 


public static final Int app_name=0x7f0a0010; 
public static final Int false_button=0x7f0a0012; 
public static final Int question_text=0x7f0a0014; 
public static final Int true buttonz0x7f0a30015; 


顺便 要 说 的 是 ， 修 改 布局 或 字符 串 等 资源 后 ，R.java 文 件 不 会 实时 更 
新 。Android Studio 另 外 还 存 有 一 份 代码 编译 用 的 R.java 隐 藏 文件 。 人 代码 
清单 1-5 中 打开 的 R.java 文 件 仅 在 应 用 安装 至 设备 或 模拟 器 前 生成 ， 因 此 
只 有 在 Android Studio 中 点 击 运行 应 用 时 ， 它 才 会 得 到 更 新 。 


R.java 文 件 通 第 比较 大 ， 代 人 码 清单 1-5 仅 展示 了 部 分 内 容 。 


可 以 看 到 R.layout.activity_main 即 来 自 该 文件 。activity_main 是 R 的 内 
部 类 ]ayout 里 的 一 个 整 型 常量 


GeoQuiz 应 用 需要 的 字符 串 同 样 具有 资源 ID。 目 前 为 止 ， 我 们 还 未 在 代 
码 中 引用 过 字符 串 ， 如 果 需 要 ， 可 以 使 用 以 下 函数 : 


setTitle(R.string.app_name) 


Android 为 整个 布局 文件 以 及 各 个 字符 串 生 成 资源 ID， 但 

activity_main.xml 布 局 文件 中 的 部 件 除 外 ， 因 为 不 是 所 有 部 件 都 需要 资 

源 ID。 在 本 章 中 ， 我 们 要 在 代码 里 与 两 个 按钮 交互 ， 因 此 只 需 为 它们 生 

成 资源 ID 即 可 。 

要 为 部 件 生成 资源 ID， 请 在 定义 部 件 时 为 其 添加 android:id 属 性 。 如 

代码 清单 1-6 所 示 ， 在 activity_main.xml 文 件 中 ， 分 别 为 两 个 按钮 添 

加 android:id 属 性 “需要 从 布局 预览 模式 切换 至 XML 代码 模式 ) 。 
代码 清单 1-6 ”为 按钮 添加 资源 ID (res/layout/activity_main.xml) 


«LinearLayout ... > 


<TextView 


android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:padding-"24dp" 

android: text="@string/question_text" /> 


<LinearLayout 


android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:orientation-"horizontal"» 


«Button 


android: 
android: 


android 


«Button 
android 


android 


</LinearLayout> 


</LinearLayout> 


id="@+id/true_button" 
layout_width="wrap_content" 


:layout height-"wrap content" 
android: 


text-"Qgstring/true button" /> 


:id="@+id/false_ button" 
android: 
android: 
:text="@string/false_ button" /> 


layout_width="wrap_content" 
layout height-"wrap content" 


注意 ，android:id 属 性 值 前 面 有 一 个 + 标志 ，android:text 属 性 值 则 
没有 。 这 是 因为 我 们 在 创建 资源 ID， 而 对 字符 串 资源 只 是 做 引用 。 


继续 学 习 之 前 ， 关 闭 R.java 文 件 ， 从 Project 视 角 切 回 至 Android 视 角 。 本 
书 主要 使 用 Android 和 视角， 当然， 如 果 你 就 喜欢 使 用 Project 视 角 ， 也 没有 


问题 。 


1.6 部件 的 实际 应 用 
接 下 来 ， 我 们 来 编码 使 用 按钮 部 件 ， 这 需要 以 下 两 个 步骤 


。 引用 生成 的 视图 对 象 ; 
e AMAA IMT as, DAMA DAY ERE 


1.6.1 引用 部 件 


既然 按钮 有 了 资源 ID， 我 们 就 可 以 在 MainActivity 中 引用 它们 了 。 在 
MainActivity.kt 文 件 中 输入 代码 清单 1-7 所 示 的 代码 (不 要 使 用 代码 自动 
补 全 功能 ， 直 接手 动 输入 ) 。 保 存 文 件 时 ， 会 看 到 代码 错误 提示 ， 不 用 
理会 ， 稍 后 会 修复 。 


代码 清单 1-7 通过 资源 ID 访问 视图 对 象 CMainAcctivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var trueButton: Button 
private lateinit var falseButton: Button 


override fun onCreate(savedInstanceState: Bundle?) { 


super .onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


trueButton - findViewById(R.id.true button) 
falseButton - findViewById(R.id.false button) 


j 
} 


在 activity 中 ， 可 以 调用 Activity.findViewById(Int) 函 数 引 用 己 生 
成 的 部 件 。 该 函数 以 部 件 的 资源 ID 作为 参数 ， 返 回 一 个 视图 对 象 。 不 
过 ， 这 里 直接 返回 的 不 是 View 视 图 ， 而 是 其 已 做 类 型 转换 后 的 Button 


TR. 


在 上 述 代 码 中 ， 我 们 使 用 按钮 的 资源 ID 获取 视图 对 象 ， 赋 值 给 对 应 的 视 
图 属性 。 既 然 只 有 在 onCreate(. . .) 函 数 里 调 

用 setContentView(...) 函 数 后 ， 视 图 对 象 才 会 实例 化 到 内 存 里 ， 那 
么 在 属性 声明 时 ， 我 们 就 得 使 用 lateinit 修 饰 符 。 这 实际 是 告诉 编译 
器 ， 在 使 用 属性 内 容 时 ， 我 们 会 保证 提供 非 空 的 View 值 。 然 后 ， 

在 onCreate(...) 中 ， 找 到 视图 对 象 并 赋值 给 对 应 的 视图 属性 。 第 3 章 
还 会 深入 学 习 onCreate(. ..) 函 数 和 activity 生 命 周 期 的 知识 。 


现在 让 我 们 来 修正 前 面 的 代码 错误 。 将 鼠标 移动 到 红色 的 错误 指示 处 ， 
可 以 看 到 两 个 相同 的 错误 提示 : Unresolved reference: Button. 


这 实际 是 告诉 你 ， 要 在 MainActivity.kt 文 件 中 导 


入 android.widget.Button 类 。 你 可 以 在 Kotlin 文 件 的 头 部 手动 输 
Aimport android.widget.Button， 也 可 以 使 用 Option+Return (或 
Alt+Enter) 快捷 键 ， 让 Android Studio 自 动 为 你 导入 。 可 以 看 到 ， 文 件 顶 
部 有 了 新 的 类 导入 语句 。 当 代码 过 到 类 引用 相关 问题 时 ， 这 种 快速 导入 
方法 往往 很 有 用 ， 建 议 经 党 采用 。 


现在 ， 代 码 错误 提示 应 该 消失 了 【如果 仍然 有 错误 ， 记 得 检查 代码 或 
XML 文件 ， 确 认 无 输入 错误 ) 。 代 码 错误 解决 了 ， 接 下 来 是 时 候 让 应 
用 文 持 交互 了 。 


16.2 ix ELISUT S 


Android 应 用 属于 典型 的 事件 驱动 类 型 。 不 像 命令 行 或 脚本 程序 ， 事 件 
驱动 型 应 用 局 动 后 ， 即 开始 等 竺 行为 事件 的 发 生 ， 比 如 用 户 点 击 茶 个 按 
钮 。《 事 件 也 可 以 由 操作 系统 或 其 他 应 用 触发 ， 但 用 户 触发 的 事件 更 直 
观 ， 比 如 扣 击 按钮 。) 


应 用 等 待 某 个 特定 事件 的 发 生 ， 也 可 以 说 应 用 正在 “监听 ”特定 事件 。 为 
啊 应 某 个 事件 而 创建 的 对 象 叫 作 监听 器 Clistener) 。 监 昕 器 会 实现 特定 
事件 的 监听 器 接口 (listener interface) 。 


无 须 自 己 动手 ，Android SDK 已 经 为 各 种 事件 内 置 了 很 多 监听 器 接口 。 
当前 应 用 需要 监听 用 户 的 按钮 “点 击 ” 事 件 ， 因 此 监听 器 需 实现 
View.0OnClickListener 接 口 。 


首先 处 理 TRUE 按 钮 。 在 MainActivity.kt 文 件 中 ， 
Ree (Bundle?) 函 数 的 变量 赋值 语句 后 输入 代码 清单 1-8 所 示 的 
AG 


代码 清单 1-8 为 TRUE 按钮 设置 监听 器 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


trueButton - findViewById(R.id.true button) 
falseButton - findViewById(R.id.false button) 


trueButton.setOnClickListener ( view: View -> 
// Do something in response to the click here 


} 


Cli 38 2!) Unresolved reference: View 错 误 提 示 ， 请 使 用 
Option+Return (Alt+Enter) 快捷 键 导 入 View 类 。 ) 


在 代码 清单 1-8 中 ， 我 们 设置 了 一 个 监听 器 。 按 钮 trueButton 被 点 击 
后 ， 监 听 器 会 立即 通知 我 们 。Android 框 架 定 义 了 
View.OnClickListener 这 样 只 有 一 个 onClick(View) 单 方法 的 Java 接 
口 。 在 Java 世 界 里 ， 这 种 带 有 单一 抽象 方法 (single abstract method) 的 
接口 设计 模式 很 常见 ， 它 有 个 专门 的 名 字 叫 SAM。 


作为 和 Java 互 操作 实现 的 一 部 分 ，Kotlin 对 此 模式 设计 有 特别 支持 。 你 
只 需 编写 一 个 函数 字面 量 (function literal) ， 让 Kotlin 负 责 将 其 转换 为 
实现 这 种 SAM 接 口 的 对 象 。 这 种 内 部 转换 又 叫 作 SAM 转 换 (SAM 


conversion) 。 


这 里 ， 点 击 监听 器 是 使 用 lambda 表 达 式 实现 的 。 参 照 代 码 清单 1-9 为 
FALSE 按 钮 设置 类 似 的 事件 监听 器 。 


代码 清单 1-9 为 FALSE 按 钮 设置 监听 器 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


trueButton.setOnClickListener ( view: View -> 
// Do something in response to the click here 


} 


falseButton.setOnClickListener { view: View -> 
// Do something in response to the click here 


} 


——A^ 


1.7 创建 提示 消 忆 


接 下 来 要 实现 的 是 ， 分 别 点 击 两 个 按钮 ， 弹 出 我 们 称 之 为 toast 的 提示 消 
上 县。Android 的 toast 是 用 来 通知 用 户 的 简短 弹出 消息 ， 用 户 无 须 输入 什 
么 ， 也 不 用 做 任何 干预 操作 。 这 里 ， 我 们 要 用 toast 来 反馈 答案 ， 如 图 1- 
17 上 所 示 。 


9:00 Vic. d 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


Correct! 


图 1-17 toast 消 息 反馈 
自 先 回 到 strings.xml 文 件 ， 如 代码 清单 1-10 所 示 ， 为 toast 洪 加 消 恩 显示 用 
的 字符 串 资 源 。 
代码 清单 1-10 ”增加 toast 字 符 串 (res/values/strings.xml) 
<resources> 
«string name-"app name"»GeoQuiz«/string» 


«string name-"question text"»Canberra is the capital of Australia.</str 
«string name-"true button"»True«/string» 


«string name-"false button"»False«/string» 

«string name="correct_toast">Correct!</string> 

«string name-"incorrect toast"»Incorrect!«/string» 
</resources> 


接 下 来 更 新 监听 器 代码 以 创建 并 展示 toast 消 息 。 输 入 代码 时 可 利用 
Android Studio 的 代码 自动 补 全 功能 ， 这 可 以 节省 大 量 时 间 ， 所 以 越 早熟 
悉 它 的 使 用 越 好 。 


参照 代码 清单 1-11， 在 MainActivity.kt 文 件 中 依次 输入 代码 。 当 输入 

到 Toast 类 后 的 点 号 时 ，Android Studio 会 弹出 一 个 窗口 ， 给 出 建议 使 用 
的 Toast 类 的 常量 与 函数 。 

可 以 使 用 上 下 键 进行 选择 。 (如 果 不 想 使 用 代码 自动 补 全 功能 ， 请 不 要 
按 Tab 键 、Return/Enter 键 ， 或 用 鼠标 点 击 弹 出 窗口 ， 只 管 继续 输入 代码 
直至 完成 。) 


在 建议 列表 里 ， 选 择 makeText(context: Context, resId: Int, 
duration: Int)， 代 码 上 自动 补 全 功能 会 目 动 添加 完整 的 函数 调用 。 


en ... ) 函数 的 全 部 参数 设置 ， 完 成 后 的 代码 如 代码 清单 1- 
11 甩 不 。 


代码 清单 1-11 创建 提示 消息 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


trueButton.setOnClickListener { view: View -> 


— —44—B thi : toti Liek 
Toast.makeText( 
this, 
R.string.correct_toast, 
Toast.LENGTH_SHORT) 
.Show() 
} 


falseButton.setOnClickListener { view: View -> 


-— TM — 


Toast.makeText( 
this, 
R.string.incorrect toast, 
Toast.LENGTH SHORT) 


. show() 
} 
} 


为 了 创建 toast， 我 们 调用 了 Toast.makeText(Context!,，Int, Int) 
静态 函数 。 该 函数 会 创建 并 配置 Toast 对 象 。 该 函数 的 Context 参 数 通 
常 是 Activity 的 一 个 实例 (Activity 本 身 就 是 Context 的 子 类 ) 。 这 
里 ， 我 们 传 入 MainActivity 作 为 Context 值 参 。 


第 二 个 参数 是 toast 要 显示 字符 串 消息 的 资源 [D。Toast 类 必须 借助 
Context 才 能 找到 并 使 用 字符 串 资源 ID。 第 三 个 参数 通常 是 两 个 Toast 
常量 中 的 一 个 ， 用 来 指定 toast 消 息 的 停留 时 间 。 

创建 toast 后 ， 可 调用 Toast .show() 在 屏幕 上 显示 toast 消 息 。 


由 于 使 用 了 代码 上 自动 补 全 功能 ， 因 此 你 就 不 用 自己 导入 Toast 类 了 了， 
Android Studio 会 自动 导入 相关 类 。 


好 了 ， 现 在 可 以 运行 应 用 了 。 

1.8 ”使 用 模拟 器 运行 应 用 

运行 Android 应 用 需 使 用 人 硬件 设备 或 虚拟 设备 (virtual device) 。 包 含 在 
开发 工具 中 的 Android 设 备 模 拟 器 可 提供 多 种 虚拟 设备 。 


要 创建 Android 虚 拟 设备 (AVD) ， 在 Android Studio 中 ， 选 择 Tools 5 
AVD Manager 琳 单项 。 当 AVD 管 理 器 窗口 弹出 时 ， 点 击 窗口 左下 和 角 的 
+Create Virtual Device... 按 钮 。 


如 图 1-18 所 示 ， 在 随后 弹出 的 对 话 框 中 ， 可 以 看 到 有 很 多 配置 虚拟 设备 
的 选项 。 作 为 首 个 虚拟 设备 ， 我 们 选择 模拟 运行 Pixel 2 设备 ， 然 后 点 击 
Next 继 续 。 


Select Hardware 


M Android Studio 


Choose a device definition 


Virtual Device Configuration 


Q ; 
ey rumen n m Ru 
N Pixel XL 6.8" 1440x2.. — 560dpi 

Pixel 2 XL 5.99" — 1M. 660dpi 

Size: large 

Ratio: long 
es i Densty 420dp 
Tablet Pixel » 50 1080x1..  420dpi 

Nexus § 4,0" 480x800 — hdpi 

Nexus One 37" 480x800 — hdpi 

Nexus 6P 57 1440x2,,,  560dpi 

Nexus 6 5.96"  1440x2.. 560dpi 

Nexus 5X bo 1080x1..  420dpi 
New Hardware Profle — Import Hardware Profiles 。 è | Clone Device... | 


图 1-18 选择 虚拟 设备 


| Cancel Previous Finish 


如 图 1-19 所 示 ， 接 下 来 选择 模拟 器 的 系统 镜像 。 选 择 x86 Pie 模 拟 器 后 点 
击 Next 按 钮 继续 。 (点击 Next 按 钮 之 前 ， 如 果 需 要 下 载 模拟 器 组 件 ， 按 
提示 操作 即 可 。) 
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System Image 


从 Android Studio 


Select a system image 


Recommended x86 Images Other Images 


Oreo Download 2) 
Oreo Download 26 
Nougat Download 25 


Nougat Download 24 


x86 
x06 
x06 
X06 


Virtual Device Configuration 


Android 9.0 (Google Play) 
Android 8.1 (Google Play) 


Android 8.0 (Google Play) 


Android 7.1.1 (Google Play) | 


Android 7.0 (Google Play) 


[4| 
MJ 


图 1-19 选择 系统 镜像 


Pie 


API Level 


28 


Android 
9.0 
Google Inc. 


System Image 


x86 


We recommend these Google Play images because 
this device is compatible with Google Play. 


Questions on API level? 
See the API level distribution chart 


最 后 ， 如 图 1-20 所 示 ， 可 以 对 模拟 器 的 各 项 参数 做 最 终 修改 并 确认 。 妆 
然 ， 如 果 需 要 ， 后 面 再 修改 模拟 占 的 参数 也 行 。 现 在 ， 为 模拟 器 取 个 便 
于 识别 的 名 字 ， 点 击 Finish 按 钮 完成 虚拟 设备 的 创建 。 
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Android Virtual Device (AVD) 


M Android Studio 


Verify Configuration 


Virtual Device Configuration 


AVD Name. | Pixel 2 API 28 


(| ive 6,0 1080x1920 xxhdpi 


wre Android 0386 
Startup orientation 


Jo 


Portrait Landscape 


Emulated 


* | Automatic 
bti Graphics: Automatic 


Device Frame KA Enable Device Frame 


Change... 


Change... 


| Show Advanced Settings | 


图 1-20 模拟 器 参数 调整 


AVD Name 


The name of this AVD, 


| Cancel | | Previous | Next 


AVD 创 建成 功 后 ， 就 可 以 用 它 运 行 GeoQuiz 应 用 了 。 点 击 Android Studio 
工具 栏 上 的 Run 按 钮 ， 或 使 用 Control+R 快 捷 键 。 在 随后 出 现 的 Select 
Deployment Target 对 话 框 里 ， 选 中 刚才 配置 的 虚拟 设备 后 点 击 OK 按 
钮 ，Android Studio 会 启动 它 ， 安 装 应 用 包 (APK) 并 运 去 行 应 用 。 


模拟 器 的 启动 过 程 比较 耗 时 ， 请 耐心 等 待 。 等 设备 局 动 、 应 用 运行 后 ， 
就 可 以 在 应 用 界面 点 击 按钮 ， 让 toast 告 诉 你 答案 了 。 


假如 启动 时 或 在 点 击 按钮 时 GeoQuiz 应 用 月 尝 ， 可 以 在 Android 的 LogCat 

工具 窗口 中 看 到 有 用 的 诊断 信息 。 《如果 LogCat 没 有 自动 打开 ， 可 点 击 

Android Studio 窗 口 底部 的 Logcat 按 钮 打开 它 。 2 在 LogCat 工 具 窗口 的 搜 

p ig deus 言 息 。 如 图 1-21 所 示 ， 查 看 
日 志 ， 可 看 到 抢眼 的 红色 1! 异常 信息 。 


| :本 书 彩 图 可 到 图 灵 社 区 本 书页 面 “ 随 书 下 载 ”处 查看 。 一 一 编者 注 


Logeat à - 


H Emulator pyel 2_APL2L v | No debuggable processes v| Error vv Q Regex Show only selected applic ¥ 


ü 2019-02-21 13:42:03,209 5908-5908/1 E/AndroidRuntine; FATAL EXCEPTION: main 
Process: com Dignerdranch. android, geoquiz, PID; 5908 
d java, lang. RuntimeException; Unable to start activity ConponentInfo(com,bignerdranch, android. geoquiz/ com bignerdranch, android, geoquiz 
Mainctivity): kotlin.UninitializedPropertyAccessException: lateinit property questionTextView has not been initialized 
1 at android, app, ActivityThread, performLaunchActivity(ActivityThread, java;2913) 
i at android, app. ActivityThread, handleLaunchActivity(ActivityThread, java: 3048) 
at android, app. servertransact ion, LaunchAct ivityTtem, execute(LaunchActivityltem, java: 78) 
3 at android, app, servertransact ion, TransactionExecutor, executeCal backs (TransactionExecutor, java: 108) 
at android, app, servertransact ion, Transact ionExecutor  execute(Transact ionExecutor. java: 68) 
B at android, app. ActivityThread$H, handleMessage(ActivityThread, java: 1808) 
at android,os. Handler dispatchMessage(Handler, java; 106) 
q at android.os. Looper. loop(Looper. java: 193) 
at android, app. ActivityThread, main (ActivityThread, java:6669) <1 internal call» 
P at con, android, internal, os.RuntimeInit$MethodAndArgsCaller, run (RuntimeTnit, java:493) 
at con.android, internal, os. ZygoteInit main(ZygoteInit, java: 858) 
Caused by: kotlin.UninitialiredPropertyAccessException: lateinit property questionTextView has not been initialized 
at com. bignerdranch, android, geoquiz.MainActivity, updateQuestion(MainActivity, kt;90) 
d at con bignerdranch. android. geoquiz.MainActivity. onCreate(MainActivity, kt:54) 
at android, app.Activity, performCreate(Activity, java: 7136) 


ik at android, app. Activity. performCreate(Activity, java: 7127) 
at android, app. Instrumentation, callactivityOnCreate( Instrumentation, java: 1271) 
) at android, app. ActivityThread. performLaunchActivity(ActivityThread, java:2893) «8 more...» <1 internal call» «2 mere...» 
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图 1-21 NullpointerException 异 常 示 例 


将 你 输入 的 代码 与 书 中 的 代码 做 一 下 比较 ， 找 出 错误 并 修正 ， 然 后 尝试 
重新 运行 应 用 《第 3 章 和 第 5 章 还 会 深入 介绍 LogCat 和 代码 调试 的 知 


识 ) 。 


学 习 过 程 中 最 好 不 要 关 掉 模拟 器 ， 这 样 就 不 必 在 反复 运行 调试 应 用 时 浪 
费时 间 等 待 AVD 启 动 了 。 


点 击 AVD 模 拟 器 上 的 后 退 按钮 可 以 停止 应 用 。 这 个 后 退 按钮 的 形状 像 一 
个 指 向 左 侧 的 三 角形 《在 较 早 版 本 的 Android 中 ， 它 像 一 个 U 型 箭头 ) 。 
需要 调试 变更 时 ， 再 通过 Android Studio 重 新 运行 应 用 。 


模拟 器 虽然 好 用 ， 但 在 实体 设备 上 测试 应 用 能 获得 更 准确 的 结果 。 在 第 
2 章 中 ， 我 们 会 在 实体 设备 上 运行 GeoQuiz 应 用 ， 还 会 为 GeoQuiz 应 用 添 
加 更 多 地 理 知 识 问 题 。 


1.9 深入 学 习 : Android 编 译 过 程 


学 到 这 里 ， 你 可 能 迫切 想 了 解 Android 是 如 何 编译 的 。 你 已 看 到 ， 在 项 
目 文件 有 变动 时 ，Android Studio 无 须 指 示 便 会 自动 进行 编译 。 在 整个 编 
译 过 程 中 ，Android 开 发 工具 将 资源 文件 、 代 码 以 及 AndroidManifest.xml 
文件 (包含 应 用 的 元 数据 〉 编译 生成 .apk 文 件 。 为 了 在 模拟 器 上 运 

行 ，.apk 文 件 还 需 以 debug key 签 名 。 《分 发 .apk 应 用 给 用 户 时 ， 应 用 必 
须 a key 签 名 。 要 进一步 了 解 编 译 过 程 ， 可 参考 Android 开 发 文 
Ri. 


那么 ，activity_main.xzml 布 局 文件 的 内 容 是 如 何 转变 为 View 对 象 的 呢 ? 
作为 编译 过 程 的 一 部 分 ，aapt2 (Android Asset Packaging Tool) 将 布局 
文件 资源 编译 压缩 紧凑 后 ， 打 包 到 .apk 文 件 中 。 然 后 ， 

在 MainActivity 类 的 onCreate(Bundle?) 函 数 调 
FusetContentView(...) raat, MainActivityl# 

用 LayoutInflater 闫 洋人 化 布局 文 伯 中 定义 的 每 一 人 view 多 如 图 
1-22HÀTZRe 


| 
| 
| 
| 
| 


se(ContentView(R.layout.activity_main) 


<LinearLayout ...> >ClassLoader.loadClass('LinearLayout" 


LinearLayout 


<TextView ,人 —> ClassLoader load Class( TexiView) 
| 
| 
| 
| 
| 
«LinearLayout...» ClassLoader. loadClass{"LinearLayout' 
| 
| 
| 
| 


<Button ,人 ——»ClassLoader.loadClass('Button’ 
| 

Button .> ——9X» ClassLoader oadClass('Button' 
| 
| 
| 


图 1-22 activity_main.xml 中 的 视图 实例 化 


《除了 在 XML 文件 中 定义 视图 外 ， 也 可 以 在 activity 里 使 用 代码 创建 视 

图 类 。 不 过 ， 从 设计 角度 来 看 ， 应 用 展现 层 与 逻辑 层 分 离 有 很 多 好 处 ， 
其 中 最 主要 的 一 点 是 可 以 利用 SDK 内 置 的 设备 配置 变更 ， 这 一 点 将 在 第 
3 草 中 详细 讲解 。) 


有 关 XML 不 同属 性 的 工作 原理 以 及 视图 如 何 显示 在 屏幕 上 等 更 多 信 
上 县， 请 参见 第 10 章 。 


Android 编 译 工 具 


当前 ， 我 们 看 到 的 项 目 编译 都 是 在 Android Studio 里 执行 的 。 编 译 功 能 
整合 到 IDE 中 ，IDE 负 责 调用 aapt2 等 Android 标 准 编译 工具 ， 但 编译 过 程 
本 身 仍 由 Android Studio 管 理 。 


有 时 ， 出 于 某 种 原因 ， 可 能 需要 脱离 Android Studio 编 译 代 码 。 最 简单 的 
方法 是 使 用 命令 行 编译 工具 。Android 编 译 系统 使 用 的 编译 工具 叫 
Gradle. 


(注意 ， 能 读 懂 本 节 内 容 并 控 步 又 操作 是 最 好 的 。 如 末 看 不 懂 ， 甚 至 不 


知道 为 什么 要 手动 编译 代码 ， 或 者 是 无 法 正确 使 用 命令 行 ， 也 不 必 太 在 
意 ， 请 继续 学 习 下 一 章 内 容 。 命 令 行 工具 的 具体 使 用 不 在 本 书 讨论 范围 


要 从 命令 行使 用 Gradle， 请 切换 至 项 目 目录 并 执行 以 下 命令 : 
如 果 是 Windows 系 统 ， 执 行 以 下 命令 : 


> gradlew.bat tasks 


执行 以 上 命令 会 显示 一 系列 可 用 任务 。 你 需要 的 任务 是 installDebug， 
此 ， 再 执行 以 下 命令 : 


$ ./gradlew installDebug 


如 果 是 Windows 系 统 ， 执 行 以 下 命令 : 


> gradlew.bat installDebug 


以 上 命令 将 把 应 用 安装 到 当前 连接 的 设备 上 ， 但 不 会 运行 它 。 要 运行 应 
用 ， 需 要 在 设备 上 手动 启动 。 


1.10 ”关于 挑战 练习 


本 书 大 部 分 章 末 安排 了 挑战 练习 ， 需 要 你 独立 完成 。 有 些 较 简 单 ， 就 是 
练习 所 学 知识 。 有 些 较 难 ， 需 要 较 强 的 问题 解决 能 


希望 你 一 定 完成 这 些 练习 。 攻 元 它 们 不 仪 可 以 巩固 所 学 知识 ， 树 立信 
心 ， 还 可 以 让 自己 从 被 动 学 习 者 快速 成 长 为 自主 开发 的 Android 程 序 


r3 
ie 
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再 来 。 如 果 仍 然 无 法 解决 ， 可 访问 本 书 论坛 ， 看 看 其 他 读者 发 布 的 解决 
方案 。 当 然 你 也 可 以 发 布 问题 和 答案 ， 与 其 他 读者 一 起 交流 学 习 。 


为 避免 搞 乱 当前 项 目 ， 建 议 你 在 Android Studio 中 先 复制 当前 项 目 ， 然 后 
在 复制 的 项 目 上 做 练习 。 


在 你 的 机 器 上 ， 通 过 文件 浏览 器 找到 项 目 文件 的 根 目 录 ， 复 制 一 份 
GeoQuiz 文 件 并 重合 名 为 GeoQuiz Challenge。 回 到 Android Studio 中 ， 选 
择 File ^ Import Project... 琳 单项， 通过 导入 功能 找到 GeoQuiz Challenge 
并 导入 。 这 样 ， 复 制 项 目 束 在 新 窗口 中 打开 了 。 开 始 挑战 吧 ! 


1.11 挑战 练习 : 定制 toast 消 息 


这 个 练习 要 你 定制 toast 消 息 ， 改 在 屏幕 顶部 而 不 是 底部 显示 弹出 消息 。 
这 要 用 到 Toast 类 的 setGravity 函 数 ， 并 使 用 Gravity .TOP 重 力 值 。 
有 具体 如 何 使 用 ， 请 参考 Android 开 发 者 文档 。 


第 2 章 Android SMVCiwWit fs 


本 章 我 们 将 升级 GeoQuiz 应 用 ， 提 供 更 多 的 地 理 知 识 测试 题目 ， 结 果 如 
图 2-1 所 示 。 


9:00 Ç, i 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


NEXT 》 


图 2-1 更 多 测试 题目 


为 实现 目标 ， 我 们 需要 为 GeoQuiz 项 目 新 增 一 个 名 为 Question 的 数据 
类 。 该 类 的 一 个 实例 代表 一 道 题 目 。 


然后 再 创建 一 个 Question 对 象 集合 交 由 MainActivity 管 理 。 


2.1 创建 新 类 


在 项 目 工具 窗口 中 ， 右 键 单 击 com.bignerdranch.android.geoquiz 类 包 ， 选 
择 New > Kotlin File/Class 菜 单项 。 如 图 2-2 所 示 ， 类 名 处 输入 Question， 
类 型 选 Class， 然 后 点 击 OK 按 钮 。 


e e New Kotlin File/Class 

Name: Question it 

Kind: & Class Ig 
Cancel (Koia 


图 2-2 ”创建 Question 类 


Android Studio 会 创建 并 打开 Question.kt 文 件 。 如 代码 清单 2-1 所 示 ， 在 其 
中 新 增 两 个 成 员 变 量 和 一 个 构造 函数 。 


代码 清单 2-1 Question 类 中 的 新 增 代码 CQuestion.kt) 


data class Question(@StringRes val textResId: Int, val answer: Boolean) 


Question 类 中 封装 的 数据 有 两 部 分 : 问题 文本 和 问题 答案 (true 或 
false) 。 


这 里 ，@StringRes 注 解 可 以 不 加 ， 但 最 好 加 上 上， 原因 有 两 个 。 首 先 ， 

Android Studio 内 置 有 Lint 代 码 检 查 占 ， 有 了 该 注解 ， 它 在 编 详 时 就 知道 
构造 函数 会 提供 有 效 的 资源 D。 这 样 一 来 ， 构 造 函 数 使 用 无 效 资 源 ID 的 
情况 《比如 提供 的 资源 ID 指向 非 String 类 型 资源 ) 就 能 避免 ， 从 而 阻止 
其 次 ， 注 解 可 以 方便 其 他 开发 人 员 阅 读 和 理解 你 


为 什么 textResId 是 Int， 而 不 是 string 呢 ? 变量 textResId 用 来 保存 
地 理 知识 问题 字符 串 的 资源 DD。 资 源 有 D 总 是 Int 类 型 ， 所 以 这 里 设置 它 
为 Int。 


本 书 中 对 所 有 模型 类 都 会 使 用 data 关 键 字 。 这 么 做 你 就 会 清楚 地 知道 ， 
模型 类 都 是 用 来 保存 数据 的 。 另 外 ， 针 对 数据 类 ， 编 译 器 会 自动 定义 像 
equals()、hashCcode()、toSstring() 这 样 的 有 用 函数 ， 不 用 做 这 些 
烦琐 的 事 ， 开 发 自然 更 轻松 了 。 


这 样 ，Question 类 就 完成 了 。 稍 后 ， 我 们 会 修改 MainActivity 类 来 配 
合 Question 类 使 用 。 现 在 ， 先 整体 把 握 一 下 GeoQuiz 应 用 ， 看 看 各 个 类 
是 如 何 协同 工作 的 。 


我 们 使 用 MainActivity 创 建 Question 对 象 集合 ， 然 后 通过 
与 TextView 以 及 三 个 Button 的 交互 在 屏幕 上 显示 地 理 知 识 问题 ， 并 根 
据 用 户 的 回答 做 出 反馈 。 图 2-3 展 示 了 它们 之 间 的 关系 。 


模型 REFE 
id | i 


t 
Er textResld 


answerTrue 


控制 器 


questionBank 


MainActivity 


currentIndex 


questionTextView nextButton 


视图 〈 布 局 ) trueButton falseButton 


图 2-3 GeoQuiz 应 用 对 象 图 解 


2.2 Android ; MVC WE iE text 


如 图 2-3 所 示 ， 应 用 对 象 分 为 模型 、 视 图 和 控制 器 三 类 。Android 应 用 基 
于 模型 -视图 -控制 器 (Model-View-Controller，MVC) 的 架构 模式 进行 
设计 。MVC 设 计 模 式 表 明 ， 应 用 的 任何 对 象 ， 归 根 结 底 都 属于 模型 对 


象 、 


视 几 对 象 以 及 控制 器 对 象 中 的 一 种 。 


e. 模型 对 象 存 储 着 应 用 的 数据 和 “业务 逻辑 ”。 模 型 类 通 各 用 来 映射 与 


应 用 相关 的 一 些 事物 ， 比 如 用 户 、 商 店 里 的 商品 、 服 务 器 上 的 图 片 
或 者 一 段 电视 节目 ， 在 GeoQuiz 应 用 里 就 是 地 理 知 识 问题 。 模 型 对 
象 不 关心 用 户 界面 ， 它 的 作用 是 存储 和 管理 应 用 数据 。 


在 Android 应 用 里 ， 模 型 类 通常 就 是 我 们 创建 的 定制 类 。 应 用 的 全 
部 模型 对 象 组 成 了 模型 层 。 


GeoQnuiz 应 用 的 模型 层 由 Question 类 组 成 。 


视图 对 象 知道 如 何在 屏 攻 上 绘制 自己， 以 及 如 何 啊 应 用 户 的 输入 ， 
比如 触摸 动作 等 。 一 条 简单 的 经 验 法 则 是 ， 只 要 能 够 在 屏幕 上 看 见 
KTR, wire MAR. 


Android 目 带 很 多 可 配置 的 视图 类 。 当 然 ， 你 也 可 以 定制 开发 其 他 
视图 类 。 应 用 的 全 部 视图 对 象 组 成 了 视图 层 。 


GeoQuiz 应 用 的 视图 层 由 res/layout/activity_main.xml 文 件 中 定义 并 实 
例 化 后 的 各 类 部 件 构 成 。 


控制 器 对 象 含有 应 用 的 “逻辑 单元 ”， 是 视图 对 象 与 模型 对 象 的 联系 
纽 和 市。 控制 占 对 象 啊 应 视图 对 象 触 友 的 各 类 事件 ， 此 外 还 管理 着 模 
型 对 象 与 视图 层 间 的 数据 流动 。 


在 Android 的 世界 里 ， 控 制 器 通常 是 Activity 或 Fragment 的 子 类 
(第 8 章 将 介绍 fragment)。 


GeoQuiz 应 用 的 控制 器 层 目 前 仪 由 MainActivity 类 组 成 。 


图 2-4 展 示 了 在 啊 应 诸如 点 击 按钮 等 用 户 事件 时 ， 对 象 间 的 交互 控制 数 
据 流 。 注 意 ， 模 型 对 象 与 视图 对 象 不 直接 交互 。 控 制 占 作为 它们 之 间 的 
桥梁 ， 接 收 对 象 友 送 的 消息 ， 然 后 回 其 他 对 象 分 友 指 令 


用 户 与 视图 对 象 进行 交互 


视图 发 送 消 控制 器 更 新 


.一 息 到 控制 器 - 模型 对 象 数据 、、 
、 控制 器 根据 模型 对 - DRC 
x 的 模型 对 象 
” 象 的 变化 更 新 视图 ee 


图 2-4 MVC 数 据 控 制 流 与 用 户 交 互 
使 用 MVC 设 计 模 式 的 好 处 


随 痢 应 用 功能 的 持续 扩展 ， 应 用 往往 会 变 得 过 于 复杂 而 让 人 难以 理解 。 
以 类 组 织 代码 有 助 于 从 整体 视角 设计 和 理解 应 用 。 这 样 ， 我 们 就 可 以 按 
类 而 不 是 按 变 量 和 函数 来 思考 设计 问题 了 。 


同 理 ， 把 类 按 模型 层 、 视 图 层 和 控制 器 层 进行 分 类 组 织 ， 也 有 助 于 我 们 
Er PME JURE, 我 们 就 可 以 接 层 而 非 一 个 个 类 来 考虑 
设计 了 。 


GeoQnuiz 应 用 虽 不 复 杀 ， 但 以 MVC 分 层 模式 设计 它 的 好 处 还 是 显而易见 
的 。 接 下 来 ， 我 们 会 升级 GeoQuiz 应 用 的 视图 层 ， 为 它 添 加 一 个 NEXT 
按钮 。 你 会 发 现 ， 添 加 NEXT 按 钮 时 ， 可 以 不 用 考虑 刚才 创建 的 


Question. 


MVC 设 计 模 式 还 便于 复 用 类 。 相 比 功 能 多 而 全 的 类 ， 功 能 单一 的 专用 
类 更 有 利于 代码 复 用 。 


举例 来 说 ， 模 型 类 Question 与 用 于 显示 问题 的 部 件 坚 无 代码 逻辑 天 
联 。 这 样 ， 就 很 容易 在 应 用 里 按 需 使 用 Question 类 。 假 设 现在 想 显示 


包含 所 有 地 理 知 识 问题 的 列表 ， 很 简单 ， 下 接 利用 Question 对 象 逐 条 
ANAT LAS 


对 于 GeoQuiz 这 样 的 简单 小 应 用 ，MVC 模 式 很 合用 。 然 而 ， 当 应 用 更 
大 、 更 复杂 时 ， 控 制 层 很 可 能 也 会 随 之 膨胀 ， 变 得 非常 复杂 。 一 般 来 
讲 ， 开 发 人 员 希 望 让 activity 和 控制 占 轻 量 些 ， 计 activity 尽 量 少 包 含 一 些 
业务 逻辑 。 如 果 使 用 MVC 模 式 无 法 让 应 用 控制 器 保持 轻 量 ， 那 么 就 该 
考虑 替代 方案 了 ， 比 如 采用 MVVC 设 计 模 式 〈 详 见 第 19 章 ) 。 


2.3 更 新 视图 层 


了 解 了 MVC 设 计 模 式 后 ， 现 在 来 更 新 GeoQuiz 应 用 的 视图 层 ， 为 其 添加 
一 个 NEXT 按 钮 。 


在 Android 的 世界 里 ， 视 图 对 象 通 第 由 XML 布局 文件 生成 。GeoQnuiz 应 用 

唯一 的 布局 定义 在 activity_main.xml 文 件 中 。 布 局 定义 文件 需要 更 新 的 

es (注意 ， 为 节约 版 面 ， 不 变 的 部 件 属性 束 不 再 列 出 
a d 


LinearLayout 


xmuns:android="http://schemas, android, con/apk/res/android" 
xmlns:tools="htto://schemas android, com/tools" 


TextView 
Button 


android: Layout, width- wrap content" android: id="(@+id/next_button" 


android: Layout, heightz"wrap content" LinearLayout) android: layout _width="wrap_content" 


android: gravity="center" android: layout_height="wrap_content" 
android: padding="24dp" android: text" astring/next button" 
tools: text="@string/question_ australia" 


Button} — |Button 


android: id- Qu id/question text viey" 


图 2-5 “新 增 按钮 
应 用 视图 层 所 需 的 改动 如 下 。 
e 为 TextView 新 增 android:id 属 性 。TextView 部 件 需要 资源 ID， 


以 便 在 MainActivity 代 码 中 为 它 设置 要 显示 的 文字 。 借 助 
android:gravity="center"， 在 TextView 视 图 上 居中 显示 文 


字 。 
e 删除 TextView 的 android:text 属 性 定义 。 用 户 点 击 问题 时 ， 人 代码 
会 动态 设置 问题 文本 ， 而 不 再 需要 硬 编码 地 理 知 识 问题 了 。 


e 指定 显示 在 TextView 视 图 上 的 默认 文字 ， 这 样 布 局 预览 时 就 可 以 
看 到 。 实 现 方 式 是 为 TextView 设 置 tools :text 属 性 ， 使 
用 @string/ 语 法 形式 指 同 代表 问题 的 字符 串 资源 。 


此 外 ， 还 要 在 布局 根 标签 处 添加 tools 命 名 空间 ， 让 Android Studio 
知道 tools :text 属 性 的 意思 。 该 命名 空间 的 作用 是 ， 在 开发 预览 
时 让 tools 属 性 覆盖 部 件 的 其 他 属性 。 而 在 设备 上 运行 时 ， 系 统 会 
忽略 该 too1s 必 性。 当然 ， 你 仍然 可 以 使 用 android:text， 然 后 
在 代码 运行 时 修改 显示 文字 。 但 使 用 tools :text 更 好 ， 因 为 一 看 
便 知 它 指定 的 值 是 仅 供 预览 的 。 


e 以 根 LinearLayout 为 父 部 件 ， 新 增 一 个 Button 部 件 。 


回 到 activity_main.xml 文 件 中 ， 参 照 代 码 清单 2-2， 完 成 XML 文件 的 相应 
修改 。 


代码 清单 2-2 新 增 按钮 以 及 对 文本 视图 的 调整 


(res/layout/activity_main.xml ) 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-z"match parent" 
android:layout height-"match parent" 
E 


«TextView 
android: id="@+id/question_text_view" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:padding-"24dp" 


——andreid-text-"Qstring/question—text^" 
tools: text="@string/question_australia" /> 


<LinearLayout ... > 


</LinearLayout> 


<Button 
android: id="@t+id/next_button" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: text="@string/next_button" /> 


</LinearLayout> 


保存 activity_quiz.xml 文 件 。 这 时 ， 会 看 到 一 个 错误 提示 ， 说 缺少 字符 串 


回 到 res/values/strings.xml 文 件 ， 如 代码 清单 2-3 所 示 ， 重 命名 
question_text， 添 加 新 按钮 所 需 的 字符 串 资 源 定 义 。 
代码 清单 2-3 ”更 新 字符 串 资源 定义 (res/values/strings.xml) 


«string name-"app name"»GeoQuiz«/string» 


«string name-"question australia"»Canberra is the capital of Australia.«/st 
«string name-"true button"»True«/string» 

«string name="false_button">False</string> 

«string name="next_button">Next</string> 


BELA AFT FF strings.xml fF, Ab RARE YS JI RE ULP AREA D] REP] 8T 
串 ， 结 果 如 代码 清单 2-4 所 示 。 


代码 清单 2-4 ”新 增 问题 字符 串 Cres/values/strings.xml ) 


<string name="question_australia">Canberra is the capital of Australia.</st 
<string name="question_oceans">The Pacific Ocean is larger than 

the Atlantic Ocean.</string> 
<string name="question_mideast">The Suez Canal connects the Red Sea 

and the Indian Ocean.</string> 
«string name-"question africa"»The source of the Nile River is in Egypt.</s 
«string name-"question americas"»The Amazon River is the longest river 

in the Americas.«/string» 


«string name-"question asia"»Lake Baikal is the world\'s oldest and deepest 
freshwater lake.«/string» 


注意 最 后 一 个 字符 串 定义 中 的 \' 。 为 表示 符号 " ， 这 里 使 用 了 转 义 字 
符 。 在 字符 串 资 源 定 义 中 ， 也 可 使 用 其 他 币 见 的 转 义 字符 ， 比 如 \n 是 指 


新 行 符 。 


保存 修改 过 的 文件 ， 然 后 回 到 activity_quiz.xml 文 件 中 ， 在 图 形 布 局 工具 
里 预览 修改 后 的 布局 文件 。 


至 此 ，GeoQuiz 应 用 视图 层 的 更 新 束 全 部 完成 了 。 为 让 GeoQuiz 应 用 运 
行 起 来 ， 接 下 来 要 更 新 控制 层 的 MainActivity 类 。 

2.4 更 新 控制 磺 层 

在 上 一 章 ， 应 用 控制 器 层 的 MainActivity 类 的 处 理 逻 辑 很 简单 : 显示 
定义 在 activity_main.xml 文 件 中 的 布局 对 象 ， 为 两 个 按钮 设置 监听 器 ， 
啊 应 用 户 点 击 事件 并 创建 toast 消 息 。 


既然 现在 有 更 多 的 地 理 知 识 问题 可 以 检索 与 展示 ，MainActivity 类 就 
需要 更 多 的 处 理 逻 辑 来 让 GeoQuiz 应 用 的 模型 层 与 视图 层 协作 。 


打开 MainActivity.kt 文 件 ， 如 代码 清单 2-5 所 示 ， 创 建 一 个 Question 对 象 
集合 以 及 该 集合 的 索引 变量 。 


代码 清单 2-5 ”增加 Question 对 象 集合 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var trueButton: Button 
private lateinit var falseButton: Button 


private val questionBank = listOf( 
Question(R.string.question_australia, true), 
Question(R.string.question_oceans, true), 
Question(R.string.question_mideast, false), 
Question(R.string.question_africa, false), 
Question(R.string.question_americas, true), 
Question(R.string.question asia, true) ) 


private var currentIndex = 6 


这 里 ， 我 们 通过 多 次 调用 Question 类 的 构造 函数 ， 创 建 了 Question 对 
REF 


(在 较 复杂 的 项 目 里 ， 这 类 集合 的 创建 和 存储 会 单独 处 理 。 在 后 续 应 用 
开发 中 ， 你 会 看 到 更 好 的 模型 数据 存储 方式 。 现 在 ， 简 单 起 见 ， 我 们 选 
择 在 控制 器 层 代 码 中 创建 集合 。) 


要 在 屏幕 上 显示 一 系列 地 理 知 识 问题 ， 可 以 使 
用 questionBank、currentIndex 变 量 以 及 Question 对 象 的 存 取 方 
Ths 


如 代码 清单 2-6 所 示 ， 首 先 给 TextView 和 新 Button 添 加 属性 ， 然 后 引用 
它们 ， 并 设置 TextView 显 示 当 前 集合 索引 所 指 癌 的 地 理 知识 问题 〈 稍 
后 会 设置 NEXT 按 钮 的 点 击 事件 监听 器 ) 。 


代码 清单 2-6 使 用 TextView (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var trueButton: Button 
private lateinit var falseButton: Button 
private lateinit var nextButton: Button 
private lateinit var questionTextView: TextView 


override fun onCreate(savedInstanceState: Bundle?) { 
trueButton - findViewById(R.id.true button) 
falseButton - findViewById(R.id.false button) 
nextButton - findViewById(R.id.next button) 
questionTextView - findViewById(R.id.question text view) 
trueButton.setOnClickListener ( view: View -> 
} 


falseButton.setOnClickListener { view: View -> 


} 


val questionTextResId = questionBank[currentIndex].textResId 
questionTextView.setText(questionTextResId) 


保存 所 有 文件 ， 确 保 没 有 错误 发 生 ， 然 后 运行 GeoQuiz 应 用 。 可 以 看 
到 ， 集 合 存 储 的 第 一 个 问题 显示 在 TextView 上 了 。 


现在 来 处 理 NEXT 按 钮 ， 为 其 设置 监听 器 View.0OnClLlickListener。 访 
监听 器 的 作用 是 让 集合 索引 递增 并 相应 地 更 新 TextView 的 文本 内 容 ， 
如 代码 清单 2-7 所 示 。 


代码 清单 2-7 使 用 新 增 的 按钮 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
falseButton.setOnClickListener { view: View -> 


} 


nextButton.setOnClickListener ( 
currentIndex = (currentIndex + 1) % questionBank.size 
val questionTextResId = questionBank[currentIndex].textResId 
questionTextView.setText(questionTextResId) 


} 


val questionTextResId = questionBank[currentIndex].textResId 
questionTextView. setText (questionTextResId) 


注意 到 了 吗 ? 同样 的 questionTextView 文 字 赋 值 代 码 出 现在 了 两 个 不 
同 的 地 方 。 参 照 代 码 清 单 2-8， 人 论点 儿 时 间 把 这 样 的 公共 代码 放 到 一 个 
函数 里 ， 然 后 分 别 在 nextButton 监 听 器 里 以 及 onCreate(Bundle?) 郴 
数 的 末尾 调用 它 。 后 一 个 调用 是 为 了 初始 化 设置 activity 视 网 中 的 文本 。 


代码 清单 2-8 使 用 updateQuestion() 封 装 公 共 代 码 
(MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


nextButton.setOnClickListener ( 
currentIndex = (currentIndex + 1) % questionBank.size 


updateQuestion() 
} 


private fun updateQuestion() { 
val questionTextResId = questionBank[ currentIndex] .textResId 
questionTextView. setText (questionTextResId) 


运行 GeoQuiz 应 用 ， 验 证 新 添加 的 NEXT 按 钮 。 

如 果 一 切 正常 ， 问 题 应 该 已 经 完美 显示 出 来 了 。 当 前 ，GeoQuiz 应 用 认 
为 所 有 问题 的 答案 都 是 true， 下 面 着 手 修 正 这 个 逻辑 错误 。 同 样 ， 为 避 
免 代码 重复 ， 我 们 将 解决 方案 封装 在 一 个 私有 函数 里 。 

要 添加 到 MainActivity 类 的 函数 如 下 : 


private fun checkAnswer(userAnswer: Boolean) 


该 函数 接受 布尔 类 型 的 变量 参数 ， 判 别 用 户 点 击 了 TRUE 还 是 FALSE 按 
钮 。 然 后 ， 将 用 户 的 答案 同 当 前 Question 对 象 中 的 答案 做 比较 ， 判 断 


正 误 ， 并 生成 一 个 toast 消 息 反 馈 给 用 户 。 


在 MainActivity.kt 文 件 中 ， 添 加 checkAnswer(Boolean) 函 数 的 实现 代 
码 ， 如 代码 清单 2-9 所 示 。 


代码 清单 2-9 ”增加 checkAnswer(Boolean) 函 数 
(MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private fun updateQuestion() { 


} 


private fun checkAnswer(userAnswer: Boolean) { 
val correctAnswer = questionBank[currentIndex].answer 


val messageResId = if (userAnswer == correctAnswer) { 
R.string.correct toast 

} else { 
R.string.incorrect_toast 


} 


Toast.makeText(this, messageResId, Toast.LENGTH SHORT) 
.Show() 


在 按钮 的 监听 器 里 ， 调 用 checkAnswer(Boolean) 函 数 ， 如 代码 清单 2- 
10 所 示 。 


代码 清单 2-10 调用 checkAnswer(Boolean) 函数 
(MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


trueButton.setOnClickListener { view: View -> 


—Feasti makeFext{ 


checkAnswer (true) 


} 


falseButton.setOnClickListener { view: 


checkAnswer (false) 


View -> 


= 


运行 GeoQuiz 应 用 ， 确 认 toast 消 息 基 于 用 户 点 击 给 出 了 正确 反馈 。 


2.5 ”添加 网 标 资源 


GeoQuiz 应 用 现在 已 经 可 用 了 。 如 果 NEXT 按 钮 上 能 够 显示 向 右 的 图 
标 ， 用 户 界 面 看 起 来 更 简洁 美观 。 


本 书 随 书 文件 中 提供 了 这 样 的 箭头 图 标 。 每 章 一 个 ， 随 书 文件 包括 本 书 
全 部 Android Studio 项 目 文 件 。 


下 载 随 书 文件 ， 找 到 并 打开 02_MVC/GeoQuiz/app/src/main/res 目 录 。 在 
该 目录 下 ， 可 以 看 到 drawable-hdpi、drawable-mdpi、drawable-xhdpi、 
drawable-xxhdpi 和 drawable-xxxhdpi 五 个 目录 。 


五 个 目录 各 目的 后 级 名 代表 设备 的 像素 密度 。 


mdpi: 中 等 像素 密度 屏幕 ( 约 160dpi) 。 

hdpi: 高 像素 密度 屏幕 ( 约 240dpi) 。 

xhdpi: 超 高 像素 密度 屏幕 ( 约 320dpi) 。 
xxhdpi: 超 超 高 像素 密度 屏幕 ( 约 480dpi) 。 
xxxhdpi: 超 超 超 高 像素 密度 屏幕 〈 约 640dpi) 。 


本 书 用 不 到 它们 ， 因 此 未 包括 在 
> ) 


每 个 目录 下 有 两 个 图 片 文件 : arrow_right.png 和 arrow_left.png。 这 些 图 
片 文 件 都 是 按照 目录 名 对 应 的 dpi 定 制 的 。 


GeoQuiz 项 目 中 的 所 有 图 片 资源 都 会 随 应 用 安装 在 设备 里 ，Android 操 作 
系统 知道 如 何 为 不 同 设备 提供 最 佳 匹 配 。 注 意 ， 在 为 不 同 设备 准备 适 配 
图 片 的 同时 ， 应 用 安装 包容 量 也 随 之 增 大 。 当 然 ， 对 于 GeoQnuiz 这 样 的 
小 项 目 ， 问 题 并 不 明显 。 


如 琳 应 用 不 包含 设备 对 应 的 屏 关 像素 密度 文件 ， 则 在 运行 时 ，Android 
系统 会 目 动 找到 可 用 的 图 片 资源 ， 并 针对 该 设备 进行 缩放 适 配 。 有 了 这 


种 特性 ， 惑 不 一 定 要 准备 各 种 屏幕 像 系 密 度 文件 了 。 因 此 ， 为 控制 应 用 
包 的 大 小 ， 可 以 只 为 主流 设备 准备 分 辨 率 较 高 的 定制 图 片 资源 。 全 于 那 
些 不 常见 的 低 分 辨 紊 设备， 让 Android 系 统 自动 适 配 就 好 。 


(第 22 章 会 介绍 为 屏幕 像素 密度 定制 图 片 的 奉 代 方案 ， 另 外 ， 还 会 解释 
mipmap 目 录 的 用 途 。) 


2.5.1 问 项 目 中 添加 资源 
接 下 来 ， 将 图 片 文件 添加 到 GeoQuiz 项 目 资源 中 去 。 
首先 ， 确 认 打 开 了 Android Studio 的 Project 视 角 模 式 。 如 图 2-6 所 示 ， 展 


JFGeoQuiz/app/src/main/res 目录 会 看 到 已 有 mipmap-hdpi 和 mipmap-xhdpi 
这 样 的 目录 。 


r E Project ~ orf & -| 
A ' Ex GeoQuiz ~/writing/android/book/tfMVC/solution/GeoQuiz 
|=1 P» a .gradle 
| > MM .idea 
v Wapp 
> Ba build 
v Besrc 
> M androidTest 
" {main 
> M java 
Bz res 
s drawable 
drawable-v24 
© layout 
BN mipmap-anydpi-v26 
> B mipmap-hdpi 
Bl mipmap-mdpi 
Ex mipmap-xhdpi 
B mipmap-xxhdpi 
B mipmap-xxxhdpi 
te values 


k% AndroidManifest.xml 
a Ba tact 


12-6 ”在 Project 视 角 模 式 下 碍 看 资源 


在 随 书 文件 中 ， 选 择 并 复制 drawable-hdpi、drawable-mdpi、drawable- 
xhdpi、drawable-xxhdpi 和 drawable-xxxhdpi 这 五 个 目录 ， 将 它们 粘贴 到 
app/src/main/res 目 录 中 。 完 成 后 ， 在 Android Studio 的 项 目 工 具 窗 口 可 以 


看 到 这 五 个 目录 ， 每 个 目录 中 含有 对 应 的 arrow_left.png 和 
arrow_right.png 文 件 ， 如 图 2-7 所 示 。 


gm Project ~ © > g- 
[4 7 R2 GeoQuiz ~/writing/android/book/tfMVC/solution/GeoQuiz 
im Ba .gradle 
.idea 
z app 
build 
src 
androidTest 
main 
java 
Sees 
drawable 
drawable-hdpi 
= arrow_left.png 
=| arrow right.png 
drawable-mdpi 
z arrow left.png 
=| arrow right.png 
drawable-v24 
drawable-xhdpi 
z arrow left.png 
z arrow right.png 
drawable-xxhdpi 
z arrow left.png 
=| arrow right.png 
drawable-xxxhdpi 
=) arrow left.png 
=| arrow right.png 


dad 


图 2-7 drawable 目 录 中 的 箭头 图 标 文 件 


如 果 将 项 目 工具 窗口 切换 回 Android 视 角 模式 ， 新 增加 的 drawable 图 片 资 
源 会 以 图 2-8 所 示 的 形式 展示 。 


两 


7: Structure 


ites 


y ‘@ Android ~ IDE | eel = 
£ v app 
“i B manifests 
e" à 
B java 


Wz generatedJava 
=res 
arrow_left (5) 
=) arrow left.png (hdpi) 
=) arrow left.png (mdpi) 
=| arrow left.png (xhdpi) 
= arrow left.png (xxhdpi) 
= arrow left.png (xxxhdpi) 
arrow. right (5) 
=| arrow right.png (hdpi) 
=) arrow right.png (mdpi) 
=) arrow right.png (xhdpi) 
z arrow right.png (xxhdpi) 
z arrow right.png (xxxhdpi) 
kx: ic, launcher. background.xml 
kxi ic launcher foreground.xml (v24) 


lavout 


图 2-8 drawable 目 录 中 的 箭头 图 标 文 件 汇总 


同 应 用 添加 图 片 就 这 么 人 简单。 任何 添加 到 res/drawable 目 录 中 ， 后 级 名 
为 .png、.jpg 或 者 .gif 的 文件 都 会 自动 获得 资源 ID。 注意， 文件 名 必须 
是 小 写字 母 且 不 能 有 空格 。 

这 些 资 源 ID 并 不 按照 屏幕 像素 密度 匹配 ， See Mcd 
的 屏幕 像素 密度 ， 只 要 在 代码 中 引用 这 些 资 源 ID 就 可 以 了 。 应 用 运 
时 ， 操 作 系 统 知道 如 何在 特定 的 设备 上 显示 匹配 的 图 片 。 


Android 资 源 系统 是 如 何 工 作 的 ? 从 第 3 章 起 ， 我 们 会 深入 学 习 这 方面 的 
相关 知识 。 现 在 ， 能 显示 右 箭头 图 标 就 可 以 了 。 


2.5.2 ”在 XML 文件 中 引用 资源 


在 代码 中 可 以 使 用 资源 ID 引用 资源 。 如 果 想 在 布局 定义 中 配置 NEXT 按 
钮 显示 箭头 图 标 ， 该 如 何在 布局 XML 文件 中 引用 资源 呢 ? 


案 很 简单 ， 只 是 语法 稍 有 不 同 而 已 。 打 开 activity_main.xml 文 件 ， 
Suputtons tt SON TIT RE, 如 代码 清单 2-11 所 示 。 


代码 清单 2-11 为 NEXT 按 钮 增加 图 标 


(res/layout/activity_main.xml ) 


<LinearLayout 


<LinearLayout 


</LinearLayout> 


<Button 
android: id="@+id/next_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android: text="@string/next_button" 
android: drawableEnd="@drawable/arrow_right” 
android: drawablePadding="4dp" /> 


</LinearLayout> 


在 XML 资源 文件 中 ， 可 以 通过 资源 类 型 和 资源 名 条 尔 引用 其 他 资源 。 以 
@string/ 开 头 的 定义 是 引用 字符 串 资 源 。 以 6@drawable/ 开 头 的 定义 是 
引用 drawable 资 源 。 


从 第 3 章 开 始 ， 我 们 还 会 学 习 更 多 资源 命名 以 及 res 目 录 结 构 中 其 他 资源 
的 使 用 等 相关 知识 。 


运行 GeoQuiz 应 用 。 新 按钮 很 洒 亮 吧 ? 测试 一 下 ， 确 认 它 仍然 工作 正 
常 。 


2.6 FERRA NZ 


在 activity_main.xml 文 件 中 ， 我 们 以 dp 为 单位 指定 了 属性 值 。 下 面 来 看 
看 dp 到 底 是 什么 。 


有 时 需要 为 视图 属性 指定 大 小 尺寸 值 〈 通 和 以 像素 为 单位 ， 有 时 也 用 
点 、 上 毫米 或 英寸 !) 。 一些 常 见 的 属性 包括 文字 大 小 (text size) 、 边 距 
(margin) 以 及 内 边 距 (padding) 。 文字 大 小 指定 设备 上 显示 的 文字 像 
边 距 指定 视图 部 件 间 的 距离 ; 内 边 距 指定 视图 外 边框 与 其 内 容 
间 的 距离 。 


11 英 寸 =2.54 厘 米 。 编者 注 


在 2.5 节 中 ， 我 们 在 各 个 带 屏 幕 密度 修饰 的 drawable《〈 比 如 drawable- 
xhdpi) 下 准备 了 对 应 的 图 片 文 件 ，Android 会 用 它们 自动 适 配 不 同 像素 
密度 的 屏幕 。 那 么 问题 来 了 ， 假 如 图 片 能 自动 适 配 ， 但 边 距 无 法 缩放 适 
配 ， 或 者 用 户 配 置 了 大 于 默认 值 的 文字 大 小 ， 会 发 生 什么 情况 呢 ? 


为 解决 这 些 问 题 ，Android 提 供 了 与 密度 无 天 的 尺寸 单位 。 运 用 这 种 单 
位 ， 可 在 不 同 屏幕 像 系 密 度 的 设备 上 获得 同样 的 矿 寸 。 无 须 转换 ， 应 用 
运行 时 ，Android 会 目 动 将 这 种 单位 转换 成 像素 单位 ， 如 图 2-9 所 示 。 


Text size = 30px 
Text size = 30dp 
Text size = 30sp 


Text size = 30px 
Text size = 30dp 
Text size = 30sp 


MDPI HDPI 


'ext size = 15px 
Text size = 15dp 


Text size = 15sp 
Text size = 30px 


Text size = 30dp 
Text size = 30sp 


HDPI, large text 


图 2-9 ”使 用 与 密度 无 关 的 尺寸 单位 时 TextView 的 显示 效果 


e px 


pixel 的 缩写 ， 即 像素 。 无 论 屏幕 密度 是 多 少 ， 一 个 像素 单位 对 应 一 
个 屏幕 像素 单位 。 不 推荐 使 用 px， 因 为 它 不 会 根据 屏幕 密度 自动 缩 


放 。 


e dp (ZXdip) 


density-independent pixel] Ej, AFR TCKRA. Wit, EU 


置 边 距 、 内 边 距 或 任何 不 打算 按 像素 值 指定 尺寸 的 情况 下 ， 都 使 用 
dp 这 种 单位 。1dp 在 设备 屏幕 上 总 是 等 于 1/160 英 寸 。 使 用 dp 的 好 处 
， 无 论 屏幕 密度 如 何 ， 总 能 获得 同样 的 太 寸 。 如 果 屏 幕 密度 较 

， 那 么 密度 无 关 像素 会 相应 扩展 至 整个 屏幕 。 


un pu 


e Sp 
scale-independent pixel 的 缩写 ， 意 为 缩放 无 关 像素 。 它 是 一 种 与 密 


度 无 天 的 像素 ， 这 种 像 系 会 受用 户 字体 俩 好 设置 的 影响 。sp 通 季 用 
来 设置 屏幕 上 的 字体 大 小 。 


pt. mm, in 


类 似 于 dp 的 缩放 单位 ， 人 允许 以 点 〈L72 英 寸 ) . SRE A Br 
指定 用 户 界面 太 寸 。 实 际 开发 中 不 建议 使 用 这 些 单位 ， 因 为 并 非 所 
有 设备 都 能 按照 这 些 单位 进行 正确 的 尺寸 缩放 配置 。 


在 本 书 及 实际 开发 中 ， 通 常 只 会 用 到 dp 和 sp 这 两 种 单位 。Android 会 在 
运行 时 自动 将 它们 的 值 转换 为 像素 单位 。 


2.7 ”在 物理 设备 上 运行 应 用 


虽然 在 模拟 器 上 和 应 用 交互 不 错 ， 但 在 Android 实 体 设 备 上 运行 应 用 更 
有 意思 。 本 节 将 学 习 如 何 设置 系统 、 设 备 和 应 用 ， 实 现在 硬件 设备 上 运 
行 GeoQuiz 应 用 。 


首先 ， 将 设备 连接 到 系统 上 。Mac 系 统 应 该 会 立即 识别 出 所 用 设备 ， 
Windows 系 统 则 可 能 需要 安装 adb (Android Debug Bridge) Jkz/J. p 
Windows 系 统 目 吴 无 法 找到 adb 驱 动 ， 请 去 设备 生产 商 的 网 站 下 载 。 


其 次 ， 需 要 打开 设备 的 USB 调 试 模式 。 开 发 者 选项 默认 不 可 见 。 先 选择 
Settings > About Tablet/Phone 选 项 ， 找 到 并 点 击 Build Number 七 次 以 局 
用 它 。 点 击 过 程 中 ， 系 统 会 弹出 一 个 消息 框 告诉 你 还 要 具体 点 多 少 次 。 
等 收 到 You are now a developer! 消 息 时 停 下 ， 回 到 Settings 项 ， 选 择 
Developer 项 ， 找 到 并 勾 选 USB debugging 选 项 。 


不 同 版 本 设备 的 设置 方法 有 很 大 差别 。 如 果 在 设置 过 程 中 遇 到 问题 ， 请 
访问 Android 开 发 者 网 站 求助 。 


最 后 ， 可 选择 Android Studio 底 部 的 Logcat 按 钮 ， 打 开 Logcat 工 具 窗 口 确 
认 设 备 已 识别 。 如 果 设 备 连接 成 功 ， 你 会 在 该 窗口 左上 和 角 看 到 已 连接 设 
备 的 下 拉 列 表 ，AVD 以 及 硬件 设备 应 该 就 列 在 其 中 ， 如 图 2-10 所 示 。 


Logcat 


s Emulator Pixel 2 API 28 Androi ~ | | com.bignerdranch.andr 


Google Pixel 2 XL Android 9, API 28 qe 


*i 2019-02-05 19:47:57.674 8797-8797/? W/android.geoqui: 
2019-02-05 19:47:57.745 8797-8797/? D/OpenGLRenderer: 
2019-02-05 19:47:57.821 8797-8823/? I/ConfigStore: and 
2019-02-05 19:47:57.822 8797-8823/? I/ConfigStore: and 
2019-02-05 19:47:57.822 8797-8823/? I/OpenGLRenderer: 

= 2019-02-05 19:47:57.822 8797-8823/? D/OpenGLRenderer: 

. 2019-02-05 19:47:57.822 8797-8823/? W/OpenGLRenderer: 

= 2019-02-05 19:47:57.822 8797-8823/? D/OpenGLRenderer: 
2019-02-05 19:47:57.827 8797-8823/? D/EGL emulation: e 

CG 2019-02-05 19:47:57.828 8797-8823/? D/EGL emulation: e 
2019-02-05 19:47:57.887 8797-8823/? D/EGL emulation: e 


b,4:Run = 6:Logcat := TODO Terminal | ^ Build a Profil 
图 2-10 ”查看 已 连接 设备 


如 果 设 备 无 法 识别 ， 请 首先 确认 是 否 已 打开 Settings 和 Developer 选 项 。 
J 请 访问 Android 开 发 者 网 站 ， 或 访问 本 书 论坛 求 
助 。 


再 次 运行 GeoQuiz 应 用 ，Android Studio 会 询问 是 在 虚拟 设备 还 是 物理 设 
备 上 运行 应 用 。 选 择 物理 设备 并 继续 。 稍 等 片刻 ，GeoQnuiz 应 用 应 该 已 
经 在 设备 上 运行 了 。 


gn Android Studio 没 有 给 出 选项 ， 应 用 依然 在 虚拟 设备 上 运行 ， 请 按 以 
上 步骤 重新 检查 设备 设置 ， 并 确保 设备 与 系统 已 正确 连接 。 然 后 ， 再 检 

查 运行 配置 是 是 否 有 问题 。 要 修改 运行 配置 ， 请 选择 Android Studio 窗 口 靠 
近 顶 部 的 app 下 拉 列 表 ， 如 图 2-11 所 示 。 


人 | 到 appv| 卫 人 Š i 


1 Edit Configurations... 
E | 


| xa 
è~ lun i, EARN p 


图 2-11 打开 运行 配置 
选择 Edit Configurations... 打 开 运 行 配置 编辑 窗口 ， 如 网 2-12 所 示 。 


000 
v 


t+-Bpovek li 
(Y = Android App 


> # Templates 


Run/Debu Configurations 


Name ap 


Module: da . 


Installation Options 


Launch Options 


Launch: Deut Activity | 


General Miscellaneous Debugger Profiling 


Deploy: | Default APK Y | | Deploy as instant app 


Install Flags; | Options to ‘pm instal’ command 


| Launch Flags: | Options to ‘am start’ command 
Deployment Target Options 


Target: pen Select Deployment Target Dialog — ™ 


(] Use same device for future launches 


Y Before launch: Gradle-aware Make 
iÈ Gradle-aware Make 


t= fav 


( Show this page [C Activate tool window 


“Cano Apply 


图 2-12 运行 配置 界面 

选择 窗口 左 侧 区 域 的 app， 确 认 已 选中 Deployment Target Options 区 域 的 
Open Select Deployment Target Dialog 选 项 。 点 击 OK 按 钮 并 重新 运行 应 
用 。 现 在 ， 你 应 该 能 看 到 可 以 运行 应 用 的 设备 选项 了 。 

2.8 挑战 练习 : 为 TextView 诺 加 监听 器 


NEXT 按 钮 不 错 ， 但 如 果 用 户 点 击 应 用 的 TextView 文 字 区 域 (地 理 知 识 
问题 )》， 也 可 以 跳 转 到 下 一 道 题 ， 用 户 体验 会 更 好 。 


提示 TextView 也 是 View 的 子 类 ， 因 此 和 Button 一 样 ， 可 
为 TextView 设 置 View.OnClickListener 监 听 器 。 


2.9 ”挑战 练习 : WIE E E 


为 GeoQuiz 应 用 新 增 后 退 按钮 (PREV) ， 用 户 点 击 时 ， 可 以 显示 上 一 道 
测试 题目 。 完 成 后 的 用 户 界 面 应 如 图 2-13 所 示 。 


9:00 vl 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


( PREV NEXT 》 


图 2-13 添加 了 后 退 按钮 的 用 户 界 面 
这 是 个 很 棒 的 练习 ， 需 回顾 本 章 和 上 一 章 的 内 容 才 能 完成 。 


2.10 ”挑战 练习 : 从 按钮 到 图 标 按 钮 
E E 
T5 3€. 


9:00 vl 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


€ ») 


图 2-14 只 显示 图 标的 按钮 
要 完成 此 练习 ， 需 将 普通 的 Button 部 件 蔡 换 成 ImageButton 部 件 。 


ImageButton 部 件 继承 自 ImageView。Button 部 件 则 继承 自 
TextView。ImageButton 和 Button 与 View 间 的 继承 关系 如 图 2-15 所 


ZN o 


| 继承 自 | 继承 自 
A D 
| 继承 自 | 继承 自 


图 2-15 ”ImageButton 和 Button 与 View 间 的 继承 关系 


以 ImageButton 按 钮 蔡 换 Button 按 钮 ， 删 除 NEXT 按 钮 的 text 以 及 
drawable 属 性 定义 ， 并 添加 ImageView 属 性 : 


< 


—Butten 

— ImageButton 
android: id="@+id/next_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 


android: src="@drawable/arrow_right" 
/> 


当然 ， 为 了 使 用 ImageButton， 还 要 调整 MainActivity 类 的 代码 。 


换 成 ImageButton 按 钮 后 ，Android Studio 会 警告 说 找 不 
到 android:contentDescription 属 性 定义 。 该 属性 能 为 视力 障碍 用 


户 提供 方便 。 在 为 其 设置 文字 属性 值 后 ， 如 果 设 备 的 可 访问 性 选项 做 了 
相应 设置 ， 那 么 在 用 户 点 击 图 形 按钮 时 ， 设 备 便 会 读 出 属性 值 的 内 容 。 


最 后 ， 为 每 个 ImageButton 都 添加 上 android:contentDescription 
属性 定义 。 


第 3 章 activity 的 生命 周期 


本 章 ， 我 们 来 学 习 并 了 解 可 怕 又 常见 的 设备 “旋转 问题 ”是 如 何 发 生 的 。 
此 外 ， 还 会 学 习 如 何 利用 设备 旋转 问题 背后 的 运行 原理 ， 实 现 让 设备 处 
于 横 屏 状态 下 显示 另 一 种 视 岁 布局 ， 如 图 3-1 所 示 。 


Canberra is the capital of Australia. 


TRUE FALSE 


图 3-1 GeoQuiz 应 用 的 横 屏 模式 


3.1 旋转 GeoQuiz 应 用 


GeoQuiz 应 用 看 起 来 不 错 ， 但 设备 一 旋转 问题 就 来 了 。 在 应 用 运行 时 ， 
扩 击 NEXT 按 钮 显示 下 一 题 ， 然 后 旋转 设备 。 如 由 你 用 的 是 模拟 器 ， 请 
扩 击 浮动 工具 栏 上 的 左旋 或 右 旋 按钮 来 旋转 设备 ， 如 图 3-2 所 示 。 


S 2 


图 3-2 ”控制 设备 旋转 


如 果 按 前 述 操 作 ， 左 旋 或 右 旋 按钮 不 起 作用 ， 请 打开 虚拟 设备 的 自动 旋 
转 功 能 。 具 体操 作 是 ;从 屏幕 上 方 朝 下 滑动 以 打开 快速 设置 。 点 击 目 左 
向 右 的 第 三 个 自动 旋转 按钮 。 如 图 3-3 所 示 ， 该 按钮 变 了 颜色 ， 表 明 自 
动 旋转 已 开启 。 


No notifications 


图 3-3 ”快速 设置 自动 旋转 

设备 旋转 后 ， 你 会 看 到 应 用 又 显示 了 第 一 道 题 。 为 什么 会 这 样 ? 这 个 问 
题 的 答案 和 activity 生 命 周 期 有 关 。 

第 4 章 会 解决 这 个 问题 。 眼 下 ， 最 重要 的 是 探究 这 个 问题 产生 的 根本 原 
因 ， 避 免 这 样 的 bug 出 现在 应 用 里 。 


3.2 activity 状 态 与 生命 周期 回调 


每 个 Activity 实 例 邦 有 其 生命 了 周期。 在 其 生命 周期 内 ，activity 在 运 
行 、 和 暂停 、 停 止 和 不 存在 这 四 种 状态 间 转 换 。 每 次 状态 转换 时 ， 都 有 相 
应 的 Activity 函 数 发 消息 通知 activity。 图 3-4 显 示 了 activity 的 生命 周 
期 、 状 态 以 及 状态 切换 时 系统 调用 的 函数 。 


onCreate(...) onDestroy() 


-整个 生命 周期 
| (对 象 实例 在 内 存 中 ) 


onStart() onStop() 


1 可 视 生命 周期 
| (视图 部 分 或 全 部 可 见 ) 


onResume()  onPause() 


图 3-4 ”activity 的 状态 图 解 


内 存 中 是 否 有 activity 实 例 、 用 户 是 人 否 可 见 、 是 售 活 跃 在 前 Su a CENE 
受用 户 输入 中 ) ， 看 图 3-4 的 各 种 状态 就 知道 了 。 完 整 总 结 结 如 表 3-1 所 
示 。 


表 3-1 activity 的 状态 


否 有 内 存 实 例 


* 某 些 场景 下 ， 和 暂停 状态 的 activity 可 能 会 部 分 或 完全 可 见 。 


不 存在 (Nonexistent) 表示 菏 个 activity 还 没 启动 或 已 销毁 例如， 用 户 
按 了 回 退 键 )》 。 因 为 已 销毁 这 个 可 能 状态 ， 所 以 不 存在 状态 有 时 被 称 为 
己 销 毁 状 态 。 此 时 ， 内 存 里 没有 这 个 activity 实 例 ， 也 没有 用 户 可 见 或 可 
交互 的 关联 视图 。 


(FIE (Stopped) 表示 某 个 activity 实 例 在 内 存 里 ， 但 用 户 在 屏幕 上 看 不 
到 关联 视图 。 在 某 个 activity 刚 开始 出 现 前 作为 瞬间 状态 存在 ， 但 在 
activity 的 关联 视图 被 完全 遮挡 时 又 重 现 该 状态 《〈 例 如 ， 用 户 局 动 另 一 个 


Er enna 点 击 Home 键 ， 或 者 使 用 预览 界面 切换 任 
) 


ea (Paused) 表示 某 个 activity 处 于 前 台 非 活动 状态 ， 关 联 视 图 可 见 或 

分 可 见 。 如 果 用 户 局 动 一 个 新 的 对 话 框 形式 ， 或 者 透明 的 activity 在 某 
E 我 们 就 说 该 activity 处 于 部 分 可 见 状态 。 一 个 activity 也 可 
能 完全 可 见 ， 但 并 不 处 于 前 台 ， 比如 用 户 在 多 窗口 模 江 (又 叫 分 屏 模 
式 ) 下 同时 查看 两 个 activity。 


运行 Resumed) 表示 某 个 activity 实 例 在 内 存 里 ， 用 户 完全 可 见 ， 且 处 
于 前 侣 。 用 户 当 前 正 与 之 交互 。 设 备 上 有 很 多 应 用 ， 但 是 ， 任 何 时候 只 
能 有 一 个 activity 处 于 能 与 用 户 交 互 的 运行 状态 。 这 也 意味 着 ， 如 末 茶 个 
activity 进 入 继续 运行 状态 ， 那 么 其 他 activity 可 能 正在 退出 运行 状态 。 


借助 图 3-4 所 示 的 函数 ，Activity 的 子 类 P ert 周期 状态 
en 这 些 函 数 通常 被 称 为 生命 周期 回调 隙 


我 们 已 熟悉 这 些 生 命 周 期 回调 函数 中 的 onCreate(Bundle?)。 pe 
activity 实 例 后 ， 但 在 此 实例 出 现在 屏幕 上 之 前 ，Android 操 作 系 统 会 
用 该 函数 。 


its, MA tionCreate(Bundle?) eA, activity P] 以 预 处 理 以 下 UI 
相关 工作 : 


。 实例 化 部 件 并 将 它们 放置 在 屏幕 上 《〈 调 
用 setContentView(Int) ; 

。 引用 已 实例 化 的 部 件 ; 

e 为 部 件 设 置 监听 器 以 处 理 用 户 交 互 ; 

。 访问 外 部 模型 数据 。 


切记 ， 于 万 不 要 上 自己 去 调用 onCreate(Bundle?) 函 数 或 任何 其 他 

activity 生 命 六 周期 函数 。 为 通知 activity 状 态 变化 ， 你 只 需 在 Activity 子 

。 这 些 函 数 ，Android 会 适时 调用 它们 “〈 看 当前 用 户 状态 以 及 系 
云 行 情况 )。 


3.3 “日志 跟踪 理解 activity 生 命 周 期 

A, BITE mi — activity E dn Jed HH ERI, WUC ese, ASIP 
fMainActivity HE mAH. Hee RAA A, UR TBE 
作 系 统 何 时 调用 了 它们 。 这 样 ， 伴 随 用 户 操作 ， MainActivity 的 状态 
如 何 变化 就 很 清楚 了 。 

3.3.1 输出 日 志 信 息 


Android 的 android.util.Log 类 能 够 向 系统 级 共享 日 志 中 心 发 送 日 志 信 
A. Logo Hg LT Hia. ARE Bi EB EU P ES: 


public static Int d(String tag, String msg) 


d 代 表 “debug”， 用 来 表示 日 志 信 息 的 级 别 。 第 一 个 参数 是 日 志 的 来 源 ， 
第 二 个 参数 是 日 志 的 具体 内 容 。 (3.7 节 会 详细 讲解 有 关 Log 级 别 的 内 
容 。) 


该 函数 的 第 一 个 参数 值 通常 以 类 名 传 入 。 这 样 ， 惑 很 容易 看 出 日 志 信 息 


的 来 源 。 


在 MainActivity.kt 中 ， 为 MainActivity 类 新 增 一 个 TAG 常量 ， 如 代码 清 
单 3-1 所 示 。 


代码 清单 3-1 ”新 增 一 个 TAG 和 常量 (MainActivity.kt) 


import ... 


private const val TAG = "MainActivity" 


class MainActivity : AppCompatActivity() { 


} 


然后 ， 在 onCreate(Bundley?) 函 数 里 调用 Log .d(...) 函 数 记 录 日 志 ， 
如 代码 清 单 3-2 所 示 。 


代码 清单 3-2 为 onCreate(Bundle?) 函 数 添加 日 志 输 出 代码 
(MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
Log.d(TAG, "onCreate(Bundle?) called") 
setContentView(R.layout.activity main) 


RE PRK, frEMainActivity2SlfJonCreate(Bundle?)2 JH, mAh 
个 生命 周期 函数 ， 如 代码 清单 3-3 所 示 。 


代码 清单 3-3 ”上 履 盖 更 多 生命 周期 函数 CMainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


override fun onStart() ( 
super.onStart() 
Log.d(TAG, "onStart() called") 


} 


override fun onResume() { 
super.onResume() 
Log.d(TAG, "onResume() called") 
} 


override fun onPause() { 
super.onPause() 
Log.d(TAG, "onPause() called") 
} 


override fun onStop() { 
super.onStop() 
Log.d(TAG, "onStop() called") 


override fun onDestroy() { 
super.onDestroy() 
Log.d(TAG, "onDestroy() called") 
j 


private fun updateQuestion() ( 


pi 


注意 ， 从 以 上 代码 可 以 看 出 ， 在 回调 有 覆盖 实现 函数 里 ， 超 类 实现 函数 总 
在 第 一 行 调 用 。 也 束 是 说 ， 必 须 首先 调用 超 类 的 实现 函数 ， 然 后 再 调用 
具体 的 日 志 记录 函数 。 


知道 为 什么 要 使 用 override 关 键 字 吗 ? 使 用 override 关 键 字 ， 束 是 要 
求 编译 器 保证 当前 类 拥有 你 要 覆 交 的 函数 。 例如 ， 对 于 如 下 拼写 错误 的 
函数 ， 编 译 器 会 发 出 警告 : 


override fun onCreat(savedInstanceState: Bundle?) { 
} 
AppPCompatActivity 父 关 没 有 onCreat (Bundle?) 函 数 ， 因 此 编译 器 发 


出 了 警告。 这 样 ， 你 就 能 及 时 改正 拼写 错误 ， 而 不 是 等 到 应 用 运行 时 ， 
才 发 现 异常 行为 ， 被 动 去 查找 问题 所 在 。 


3.3.2 ”使 用 LogCat 


运行 GeoQuiz 应 用 时 ， 应 该 能 在 Android Studio 底 部 看 见 各 种 信息 塞 满 
Logcat 工 具 窗口 ， 如 图 3- 5 所 示 。 如 果 应 用 运行 时 Logcat 没 有 自动 打开 ， 
请 点 击 Android Studio 窗 口 底部 的 Logcat 按 钮 打开 它 。 


Logcat $- 


T Emulator Pike 2 APL2B Andro v — com.bignerdranch.android.geoqui: » Verbose v Q' L Regex Show only selected application — v 


aay Ve Vi ae WRAY TUTA GUT) VH ay HUN VAM IYANU Hee MUN ad a HV MA FYE RUNGE UII aU UAI YA Quads UV 


2019-0] 13:37:48,223 24845-24845 /con.bignerdrach android, geouiz D/einktivity: onCeate Bundle?) called 
2019-02-07 13:37:48,255 24845~24845/com.bignerdranch.android, qeoquiz D/Mainctivity: onStart() called 
2019-02-07 13:37:48,256 24845-24845/com, bignerdranch android. geoquiz O/MainActivity: onResume() called 
2019-02-07 13:37:48,257 1628-1673/? O/gralloc, ranchu; gralloc alloc: Creating ashmem region of size 8298496 
2019-02-07 13:37:48,307 1628-1673/? Q/gralloc ranchu: gralloc alloc: Creating ashmem region of size 8298496 
2019-02-07 13:37:48,311 402-10873/? l/OeviceStateChecker: DeviceStateChecker cancelled 
2019-02-07 13:37:48,312 402-457/? I/MicroDetector: Keeping mic open; false 
2019-02-07 13:37:48,316 1628-1673/? D/gralloc ranchu: gralloc alloc: Creating ashmen region of size 8298496 
2019-02-07 13:37:48,317 402-10870/? I/AudioController: internalShutdown 
2019-02-07 13:37:48,317 402-24925/? I/MicroRecognitionRunner: Stopping hotword detection, 
2019-02-07 13:37:48,326 1628-1672/? Q/gralloc, ranchu; gralloc alloc: Creating ashmen region of size 8290496 
2019-02-07 13:37:48,332 402-10870/? I/MicrophoneInputStrean: mic close SR: 16000 CC : 16 50 ; 1999 
2019-02-07 13:37:48,333 402-22805/? T/MicroRecognitionfunner; Detection finished 
” 2019-02-07 13:37:48,361 24045-24882/con.biqnerdranch,android,qeoquiz D/EGL emulation: eqlMakeCurrent: 0xe69852a0: ver 3 0 (tinfo 0xe6903660) 
b,£ Run LE Gibogoat i5 TODO D Terminal A Build Qn Profiler (Event Log 


= c 


yi 


dia 


£3 


图 3-5 Android Studio 中 的 LogCat 


LogCat 窗 口中 的 各 类 混杂 信息 里 ， 有 些 是 应 用 输出 信息 ， 有 些 是 系统 输 
出 信息 。 为 方便 查找 ， 可 使 用 TAG 常 量 过 渡 日 志 输 出 。 在 LogCat 窗 口 
中 ， 点 击 右上 角 标 有 Show only selected application 的 过 滤 项 下 拉 列 表 。 
这 里 ， 当 前 选项 控制 只 显示 来 自 应 用 的 日 志 信息 。 


要 创建 过 滤 设 置 ， 选 择 过 滤 项 下 拉 列 表 里 的 Edit Filter Configuration 选 
在 Filter Name 处 输入 MainActivity， 在 Log Tag 处 同样 输入 
MainActivity， 如 图 3-6 所 示 。 


e e Create New Logcat Filter 


ap c Filter Name: MainActivity 
Specify one or several filtering parameters: 
Log Tag: [e MainActivity] Regex 
Log Message: Qy Regex 
Package Name: OQ- Regex 
PID: 
Log Level: Verbose Y 


图 3-6 ”在 LogCat 中 创建 过 滤器 


点 击 OK 按钮 。 现 在 ， 如 图 3-7 所 示 ，LogCat 窗 口 承 只 显示 Tag 为 
MainActivity 的 日 志 信 息 了 。 


Logcat $- 


il Emulator Pixel.2.APL28 Androl»  com.bignerdranch.android.geoqui; * Verbose v Q Regex MainActivity v 


a 2019-02-07 13:48:01,908 25751-25751/con, bignerdranch, android, geoquiz D/MainActivity: onCreate(Bundle?) called 
2019-02-07 13:48:01,943 25751-25751/com. bignerdranch. android, geoquiz D/MainActivity: onStart() called 
4 2019-02-07 13:48:01,944 25751-25751/con, bignerdranch, android, geoquiz D/Mainkctivity: onResune() called 


图 3-7 ”应 用 局 动 后 ， 被 调用 的 三 个 生命 周期 函数 
3.4 activity 生命 周期 如 何 啊 应 用 户 操作 


如 图 3-7 所 示 ，GeoQuiz 应 用 启动 并 创建 MainActivity 人 初始 实例 

后 ，onCreate(Bundle?)、onStart() 和 onResume() 这 三 个 生命 周期 
函数 被 调用 了 。MainActivity 实 例 现 在 处 于 运行 状态 EAH EL, 用 
户 可 见 ， 活 动 在 前 台 ) 。 


后 续 学 习 过 程 中 ， 本 书 会 1 n t RIP Fd activity I di 8 周期 函数 ， 让 应 用 
执行 一 些 任务 。 我 们 还 会 深入 学 习 各 种 生命 周期 函数 的 用 法 。 现 在 ， 借 
助 Logcat 日 志 ， 来 点 儿 有 趣 的 实验 ， 看 看 一 些 常 见 用 户 交 互 场 景 下 ， 
activity 生 命 周 期 的 函数 是 如 何 起 作用 的 。 


3.4.1 暂时 离开 activity 


如 果 还 没 运行 GeoQuiz 应 用 ， 就 先 运行 它 。 现 在 ， 点 击 主屏 幕 键 ， 随 即 
主屏 界面 出 现 了 ，MainActivity 视 图 不 见 了 。MainActivity 此 刻 处 于 
什么 状态 呢 ? 得 看 LogCat， 可 以 看 到 系统 调用 了 MainActivity 的 
onPause() 和 onSstop() 函 数 ， 但 并 没有 调用 onDestroy() 函 数 ， 如 网 
3-8 所 示 。 


Logcat Hel 


T Emulator pixeL2_APL27/ 回 combignerdranchandroidg 四 —.. [d Q Regex QuizActivity v 


a 2018-07-25 16:28:09,129 24847-24847/com.bignerdranch.android,geoquiz D/QuizActivity: onCreate(Bundle) called 
2018-07-25 16:28:09,159 24847~24847/com, bignerdranch, android, geoquiz D/QuizActivity: onStart() called 

m 2018-07-25 16:28:09,161 24847-24847/com, bignerdranch, android, geoquiz D/QuizActivity: onResume() called 

2018-07-25 16:28:14,622 24847-24847 com. bignerdranch. android. geoquiz D/QuizActivity: onPause() called 

2018-07-25 16:28:14,637 24947-24847/ com, bignerdranch, android, geoquiz D/QuizActivity: onStop() called 


E 


图 3-8 ”点 击 主屏 关键 停止 activity 


点 击 主屏 幕 键 ， 相 当 于 告诉 Android 系 统 : “我 去 别处 看 看 ， 稍 后 可 能 
来 。” 此 时 ，Android 系 统 会 先 暂 俘 ， 再 停止 当前 activity。 


这 表明 ，MainActivity 实 例 已 处 于 停止 状态 〈 在 内 存 中 ， 但 不 可 见 ， 
不 会 活动 在 前 台 ) 。 这 样 做 ， 稍 后 回 到 GeoQuiz 应 用 时 ，Android 系 统 就 
能 快速 响应 ， 重 新 启动 MainActivity， 人 恢复 到 用 户 离开 时 的 状态 。 


(点击 主屏 幕 键 后 activity 会 停止 只 是 dus lm Android 操 
作 系 统 可 能 会 销毁 暂停 应 用 。 有 具体 原因 请 参 疯 第 4 章 。) 


现在 ， 调 出 设备 的 概览 屏 ， 选 择 GeoQuiz 应 用 任务 卡 回 到 应 用 界面 。 要 
调 出 概览 屏 ， dm e 应 用 键 ， 如 图 3-9 所 示 。 


回 退 键 | 最 近 应 用 键 
主屏 幕 键 

图 3-9 ”主屏 幕 键 、 回 退 键 以 及 最 近 应 用 键 

如 果 设 备 没有 最 近 应 用 键 ， 只 有 如 图 3-10 所 示 的 单 主屏 幕 键 ， 那 就 从 屏 

幕 底 部 上 滑 打 开 概 览 屏 。 如 果 两 种 方式 都 不 管用 ， 请 查阅 设备 用 户 手 

Ht . 


图 3-10 单 主屏 幕 键 


概览 屏 的 每 张 卡片 代表 用 户 之 前 交互 过 的 一 个 应 用 ， 如 图 3-11 所 未。 
(顺便 说 一 下 ， 用 户 常 把 概览 屏 称 作 最 近 应 用 屏 或 任务 管理 融 。 不 过 ， 
既然 Google 开 发 者 文档 将 其 称 作 概 览 屏 ， 本 书 也 采用 这 种 叫 法 。) 


图 3-11 概览 屏 
在 概览 屏 中 ， 点 击 GeoQuiz 应 用 ，MainActivity 视 图 随即 出 现 。 


LogCat 日 志 显 示 ， 系 统 没有 调用 onCreate(. ..) 函 数 〈 因 为 Activity 

实例 还 在 内 存 里 ， 自 然 不 用 重建 了 ) ， 而 是 调用 了 onstart() 和 

onResume() 函 数 。 用 户 按 了 主屏 幕 键 后 ，MainActivity 最 后 进入 停止 

~ ， 再 次 调 出 应 用 时 ，MainActivity 只 需要 重新 启动 
， 用 户 可 见 ) ， 然 后 继续 运 云 行 《进入 运行 状态 ， 活 动 在 前 台 ) 


之 前 我 们 说 过 ，activity 有 时 也 会 一 直 处 于 暂停 状态 ， 用 户 将 完全 (应 用 
多 窗口 模式 ) 或 部 分 看 到 它 “〈 在 一 个 activity 之 上 局 动 带 透 明 背 景 视 图 或 
小 于 屏幕 尺寸 视图 的 新 activity 时 ) 。 下 面具 体 看 一 下 多 窗口 模式 。 


Android 7.0 (Nougat) 或 更 高 版 本 的 系统 才 文 持 多 窗口 模式 。 如 果 手 头 


设备 的 系统 版 本 较 旧 ， 可 以 使 用 模拟 器 来 做 测试 。 再 次 调 出 设备 的 概览 
屏 ， 长 按 GeoQuiz 卡 片 顶 部 的 图 标 。 选 择 Split screen 选 项 〈 图 3-12 左 
边 ) ， 在 随后 弹出 的 展示 任务 卡片 的 新 窗口 (图 3-12 中 间 〉 中 ， 任 意 选 
一 个 启动 对 应 应 用 。 


Canberra is the capital of Australia. 


Modified 


图 3-12 多 窗口 模式 下 同时 打开 两 个 应 用 


这 样 ， 束 打开 了 GeoQuiz 应 用 在 上 方 ， 第 二 个 应 用 在 下 方 的 多 窗口 模式 
(图 3-12 右 边 ) 。 


现在 ， 点 击 窗口 下 部 的 应 用 ， 然 后 查看 Logcat 日 志 。 可 以 看 

到 ， MainActivity 的 onPause() 函 数 被 调用 了 ， 它 现在 处 于 暂停 状 
态 。 点 击 窗 MainActivity 的 onResume() 函 数 
被 调用 了 ， 它 现在 处 于 运行 状态 


要 退出 多 窗口 模式 ， 自 屏幕 中 间 的 窗口 分 割 栏 向 上 或 向 下 滑动 消除 上 音 
或 下 部 窗口 即 可 。 


3.4.2 ”结束 使 用 activity 


在 设备 上 点 击 回 退 键 ， 再 查看 LogCat。 如 图 3-13 所 示 ， 日 志 显 

示 MainActivity 的 onPause()、onSstop() 和 onDestroy() 函 数 被 调用 
了 。MainActivity 实 例 处 于 不 存在 的 状态 〈 不 在 内 存 里 ， 不 可 见 ， 自 
然 也 融 不 会 活动 在 前 侣 了) 。 


Logcat it 


ES. 


TH Emulator Pie 2 APL27 A9  combignerdranchandroiigI] Oo © Regex QuizActivity 


< 2018-07-25 16:23:02,608 24847-24847/? D/QuizActivity: onCreate(Bundle) called 
2018-07-25 16:23:02,684 24847-24847/? D/QuizActivity: onStart() called 
m 2018-07-25 16:23:02,688 24847-24847/? D/QuizActivity: onResume() called 
~ 2018-07-25 16:26:49,663 2484]-24847/con.bignerdranch, android, geoquiz D/QuizActivity: onPause() called 
2018-07-25 16:26:50,028 24847-24847/com.bignerdranch. android. geoquiz D/QuizActivity: onStop() called 
2018-07-25 16:26:50,029 24847-24847/com.bignerdranch, android, geoquiz D/QuizActivity: onDestroy() called 


i 
图 3-13 点击 回 退 键 销 毁 activity 


点 击 设 备 的 回 退 键 相当 于 告诉 Android 系 统 : “activity 已 用 完 ， 现 在 不 需 
要 它 了 。” 随 即 ， 系 统 就 销 旦 有 了 该 activity 的 视图 及 其 二 内存 里 的 相关 信 
上 县。 这 实际 是 Android 系 统 节 约 使 用 设备 有 限 资 资源 的 一 种 方式 。 


在 概览 屏 界 面 ， 滑 动 消除 应 用 任务 卡片 是 男 一 种 iH Ractivity HY) 77 XX. VE 
为 开发 者 ， 你 还 不 可 以 编程 调用 ACtivity finish() 的 方式 结束 


activity。 


3.4.3 ”旋转 activity 


现在 ， 可 以 研究 本 半 开 始 时 发 现 的 应 用 缺陷 了 。 局 动 GeoQuiz 应 用 ， 点 
击 NEXT 按 钮 最 示 第 二 道 地理 知 识 问 题 ， 然 后 旋转 设备 。【〔 模 拟 器 的 旋 
转 ， 请 点 击 工具 栏 上 的 旋转 按钮 。) 


设备 旋转 后 ，GeoQuiz 应 用 又 回 到 了 第 一 道 问 题 。 查 看 LogCat 日 志 看 看 
发 生 了 什么 ， 如 图 3-14 上 所 示 。 


Logcat HL 


il Emulator Pixel 2 Apl 27 A] combignerdranch.android.gi) —.. [] Q Regex QuizActivity a 


gy 2218-0-25 16:33:51,407 CARAT com bügerdranch android geoquiz DAtvity onStart() calle 
2018-07-25 16:33:51,400 24847-24847/com, bignerdranch android, geoquiz D/QuizActivity: onResume() called 

PH 2016-07-25 16:34:53,691 24847-24847/com, bignerdranch.android.geoqui D/QuizActivity: onPause() called 
2018-07-25 16:34:53,604 24847-24847/com bignerdranch.android.geoquiz D/QuizActivity: onStop() called 
2018-07-25 16:34:53,694 24847-24847/ con, bignerdranch android, geoquiz D/QuizActivity: onDestroy() called 
2018-07-25 16:34:53,724 24847-24847/com, bignerdranch, android, geoquiz D/QuizActivity: onCreate(Bundle) called 
2018-07-25 16:34:53,753 24847-24847/com, bignerdranch android, geoquiz D/QuizActivity: onStart() called 

cj 2018-07-25 16:34:53,755 24847-2484] con, bignerdranch, android, geoquiz D/QuizActivity: onResune() called 


图 3-14 MainActivityb 7b, MainActivity/j 2 


设备 旋转 时 ， 系 统 会 销毁 当前 MainActivity 实 例 ， 然 后 创建 一 个 新 的 
MainActivity 实 例 。 再 次 旋转 设备 ， 又 一 次 见证 这 个 销毁 与 再 创建 的 


这 就 是 问题 所 在 。 每 次 旋转 设备 ， 当 前 MainActivity 实 例会 被 完全 销 
毁 ， 实 例 中 的 currentIndex 当 前 值 会 从 内 存 里 被 抹 掉 。 旋 转 后 ， 
Android 重 新 创建 了 MainActivity 新 实例 ，currentIndex 

在 onCreate(Bundle?) 疯 数 中 被 初始 化 为 09。 一 切 从 头 再 来 ， 用 户 又 看 
到 第 一 道 题 了 。 


这 个 缺陷 留 在 第 4 童 修正。 系统 为 什么 要 在 设备 旋转 时 销毁 你 的 
activity， 下 面 就 来 一 探究 竟 。 


3.5 设备 配置 改变 与 activity 生 命 周 期 


旋转 设备 会 改变 设备 配置 (device configuration) 。 设 备 配置 实际 是 一 
系列 特征 组 合 ， 用 来 描述 设备 当前 状态 。 这 些 特征 包括 : 屏幕 方向 、 屏 
幕 像 素 密 度 、 屏 幕 尺 寸 、 键 盘 类 型 、 底 座 模式 以 及 语言 等 。 


通常 ， 为 匹配 不 同 的 设备 配置 ， 应 用 会 提供 不 同 的 备 选 资源 。 为 适应 不 
同 分 辨 率 的 屏幕 ， 辐 项 目 添加 多 套 箭 头 图 标 惑 是 一 个 例子 。 


在 运行 时 配置 变更 (runtime configuration change) 发 生 时 ， 可 能 会 有 更 
合适 的 资源 来 匹配 新 的 设备 配置 。 于 是 ，Android 销 毁 当 前 activity， 为 

新 配置 寻找 最 佳 资源 ， 然 后 创建 新 实例 使 用 这 些 资源 。 来 看 一 下 实际 运 
行 效果 ， 下 面 为 设备 配置 变更 新 建 备 选 资源 ， 只 要 设备 旋转 至 水 平方 

位 ，Android 束 会 自动 发 现 并 使 用 它 。 


创建 模 屏 模式 布局 


在 项 目 工 具 窗 口中 ,右键 单 击 res 目 录 后 选择 New > Android Resource 
File 沫 单项 。 如 图 3-15 所 示 ， 创 建 资源 文件 弹出 窗口 列 出 了 资源 类 型 及 
其 对 应 的 资源 特征 。 文 件 名 (File name) 处 输入 activity_main， 资 源 类 
型 (Resource type〉 从 下 拉 列 表 中 选择 Layout， 在 根 元 素 处 输入 
FrameLayout， 然 后 保持 Source set 的 main 选 项 不 变 就 可 以 了 。 


000 New Resource File 


File name; activity main r 


Resource type: | Layout Y 
Root element: — FrameLayout 


Source set; main Y 


Directory name: | layout 


Available qualifiers: Chosen qualifiers: 
@ Country Code 
() Network Code 
® Locale 
is Layout Direction Em Nothing to show 
- Smallest Screen Width 
E Screen Width sh 
Screen Height 
f] Size 
DU Ratio 


! LI 


图 3-15 ”创建 新 的 资源 文件 


接 下 来 决定 如 何 修 饰 新 布局 资源 。 选 中 待 选 资源 特征 列表 中 的 
Orientation， 然 后 点 击 >> 按 钮 将 其 移 到 已 选 资源 特征 (Chosen 
qualifiers) 区 域 。 


最 后 ， 确 认 选 中 Screen orientation 下 拉 列 表 中 的 Landscape 选 项 ， 并 确保 

目录 名 (Directory name) 显示 为 layout-land， 结 果 如 图 3-16 所 示 。 这 个 
窗口 显示 的 配置 看 着 手 好 ， 但 实际 用 途 仅 限于 设置 存放 新 资源 文件 的 目 
录 名 。 点 击 OK 按 钮 让 Android Studio 创 建 res/layout- 


land/activity_main.xml. 


600 New Resource File 
File name: activity main H 
Resource type: | Layout | 


Root element: FrameLayout 
Source set; — main 


Directory name; — layout-land 


Available qualifiers: Chosen qualifiers: Screen orientation: 
O Network Code | 

@ Locale 

is Layout Directio | >》 

Smallest Soreer 

Screen Width | * 

Screen Height 

f Size 

D Ratio 


cc 


图 3-16  &J££res/layout-land/activity main.xml 


Android Studio 会 创建 reslayout-land 目 录 ， 并 放 入 一 个 名 为 
activity_main.xml 的 新 布局 文件 中 。 要 但 看 新 建文 件 和 文件 来， 可 把 项 

目 工 具 窗口 切换 至 Project 视 角 模 式 ， 要 得 看 文件 汇总 ， 请 切 回 Android 视 
角 模 式 。 


你 已 看 到 ，Android 如 何 为 当前 设备 配置 选择 最 佳 资 源 就 是 看 res 子 目录 


的 配置 修饰 符 。 这 里 的 -land 后 缀 名 是 配置 修饰 符 的 又 一 个 使 用 例子 。 访 
问 Android 开 发 网 页 ， 可 查看 Android 的 配置 修饰 符 列 表 及 其 代表 的 设备 
配置 信息 。 


现在 ， 我 们 有 了 一 个 横 屏 模式 布局 和 一 个 默认 布局 。 设 备 处 于 水 平方 辐 
时 ，Android 会 找到 并 使 用 res/layout-land 目 录 下 的 布局 资源 。 其 他 情况 
下 ， 它 会 默认 使 用 res/layout 目 录 下 的 布局 资源 。 注 音 ， 两 个 布局 文件 的 
文件 名 必须 相同 ， 这 样 你 才能 以 同一 资源 ID 引用 它们 。 


当前 ，res/layout-land/activity_main.xml 文 件 是 个 空 视 图 。 要 解决 这 个 问 
题 ， 可 以 打开 reslayoutactivity_main.xml 文 件 ， 复 制 根 LinearLayout 开 
闭 标签 内 容 之 外 的 全 部 内 容 ， 然 后 打开 res/layout-land/activity_main.xml 
文件 ， 粘 贴 到 它 的 FrameLayout 开 闭 标 签 之 间 。 


接 下 来 ， 参 照 代 码 清 单 3-4， 对 横 屏 模式 布局 做 出 适当 修改 。 
代码 清单 3-4 BEERS TH eve (res/layout- 


land/activity main.xml) 


«FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android:layout height-"match parent" > 


«TextView 
android: id="@+id/question_text_view" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 


android:layout gravity-"center horizontal" 
android:padding-"24dp" 
tools: text="@string/question_australia"/> 


<LinearLayout 


android: layout_width="wrap_content" 
android:layout height-"wrap content" 


android: layout_gravity="center_vertical|center_horizontal"> 


<Button 
../> 


<Button 
../> 


</LinearLayout> 


<Button 
android: id="@+id/next_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout gravity-"bottom|right" 
android: text="@string/next_button" 
android: drawableEnd="@drawable/arrow_right" 
android: drawablePadding="4dp"/> 


</FrameLayout> 


FrameLayout 是 最 简单 的 ViewGroup 部 件 ， 它 不 负责 安排 其 子 视图 的 位 
置 。FrameLayout 子 视图 的 位 置 排列 取决 于 它们 各 自 的 
android:1layout_gravity 属 性 。 因 而 ， 作 为 FrameLayout 的 子 视 
图 ，TextView、LinearLayout 和 Button 都 需要 一 

个 android:1layout_gravity 必 性。 这 里 ，LinearLayout 里 的 Button 
子 元 素 不 用 修改 ， 因 为 它 不 是 FrameLayout 的 直接 子 视 图 。 


再 次 运行 GeoQuiz 应 用 。 旋 转 设备 全 水 平方 位 ， 但 看 新 的 布局 界面 ， 如 
图 3-17 所 示 。 当 然 ， 这 不 仅 是 一 个 新 的 布局 界面 ， 也 是 一 个 新 的 
MainActivity 实 例 。 


Canberra is the capital of Australia. 


TRUE FALSE 


图 3-17 ”处 于 水 平方 位 的 MainActivity 


设备 旋转 回 竖 直 方 同 ， 可 看 到 默认 的 布局 界面 以 及 为 一 个 新 的 
MainActivity. 


3.6 ”深入 学 习 : UI 刷 新 与 多 窗口 模式 


和 暂 ， 是 迅速 过 渡 到 运行 或 停止 状态 。 考 虑 到 这 个 因素 ， 很 多 开发 者 认 
为 ， 只 有 在 activity 处 于 运行 状态 时 ， 才 需要 刷新 UI 显 示 。 而 且 ， 大 家 的 
普遍 做 法 就 是 使 用 onResume() 和 onPause() 来 启动 或 停止 UI 刷 新 〈 比 
如 动画 或 数据 刷新 ) 。 


然而 ，Nougat 引 入 多 窗口 模式 后 ， 用 户 完全 看 得 到 的 activity 不 一 定 是 正 
在 运行 的 activity 了 。 之 前 的 常规 做 法 行 不 通 了 ， 许 多 应 用 的 预定 运行 模 
式 也 失效 了 。 现 在 ， 多 窗口 模式 下 ， 和 暂停 状态 activity 也 能 长 时 间 在 屏幕 
Ec eal 能 看 到 ， 用 户 自然 希望 暂停 activity 的 运行 表现 和 运行 状 


拿 看 视频 来 说 ， 假如 有 个 Nougat 发 布 之 前 开发 的 视频 播放 应 用 ， 你 肯定 
是 在 onResume() 里 启动 或 继续 播放 视频 ， 并 在 onPause() 里 暂停 播放 
视频 。 现 在 ， 多 窗口 模式 来 了 ， 那 么 只 要 用 户 与 多 窗口 中 的 另 一 个 应 用 
交互 ， 视 频 播放 应 用 就 会 暂停 播放 。 这 时 用 户 十 分 恼火 ， 因为 他 们 就 想 


一 边 看 视频 ， 一 边 在 尺 一 个 窗口 发 消息 。 


幸运 的 是 ， 这 种 问题 很 好 解决 ， 把 继续 播放 和 和 暂停 播放 控制 放 

到 onstart() 和 onSstop() 里 。 这 适用 于 任何 需要 实时 数据 更 新 的 应 
图 片 的 图 片 库 应 用 (本 书后 面 会 开发 这 样 
JMH) 。 


简单 来 说 就 一 句 话 ，Nougat 之 后 ， 从 onStart() 到 onStop(), 在 
activity 可 见 的 整个 生命 周期 ， 你 都 应 该 刷新 UI。 


不 幸 的 是 ， 不 是 所 有 的 开发 者 都 有 这 样 的 意识 。 许 多 应 用 在 多 窗口 模式 
下 运行 异常 。 为 解决 这 个 问题 ，Android 在 2018 年 11 月 引入 了 mnulti- 
resume 方 案 来 文 持 多 窗口 模式 。 该 方案 规定 ， 多 窗口 模式 下 ， 不 管用 户 
和 哪 一 个 窗口 应 用 交互 ， 所 有 完全 可 见 的 activity 都 将 处 于 运行 状态 。 


在 Android 9.0 平 台 上 ， 只 要 在 Android manifest 文 件 里 添加 <meta-data 
android:name-"android.allow multiple resumed activities" 
android:value="true" />， 你 束 可 以 明确 指定 使 用 multi-resume 模 
式 。 (manifest 相 关内 容 将 在 第 6 草 中 学习 。) 


不 过 ， 即 便 如 上 面 那样 明确 使 用 multi-resume 模 式 ， 如 果 你 的 设备 制造 
商 没 有 跟 进 实施 multi-resume 方 案 ， 那 么 还 是 用 不 了。 本 书 撰写 时 ， 市 
面 上 还 没有 任何 设备 能 够 实现 它 。 据 传 在 下 一 个 Android 版 本 里 ，multi- 
resume 将 是 强制 性 实施 标准 。 


所 以 ， 在 multi-resume 成 为 标准 获得 大 多 数 设 备 文 持 之 前 ，UI 刷 新 代码 
到 底 放 在 哪里 合适 ， 就 要 靠 你 掌握 的 activity 生 命 周 期 知识 来 确定 了 。 本 
书后 续 章 节 中 ， 你 也 会 看 到 一 些 开 发 实践 。 


3.7 RAFA: 日 志 记录 的 级 别 与 函数 

使 用 android.util.Log 类 记录 日 志 ， 不 仅 可 以 控制 日 志 的 内 容 ， 还 可 
以 控制 日 志 级 别 ， 以 区 分 信息 重要 程度 。Android 支 持 表 3-2 所 示 的 五 种 
日 志 级 别 ， 每 一 个 级 别 对 应 一 个 Log 类 函数 。 要 输出 什么 级 别 的 日 志 ， 
调用 相应 的 Log 类 函数 即 可 。 


表 3-2 日 志 级 别 与 函数 


日 志 级 别 函数 说 明 


需要 说 明 的 是 ， 所 有 的 日 志 记 录 函 数 都 有 两 种 参数 签名 : string 
的 tag 参 数 和 msg 参 数 ; 除 tag 和 msg 参 数 外 再 加 上 Throwable 实 例 参 
数 。 应 用 抛 出 异常 时 ， 附 加 Throwab1le 实 例 参数 方便 记录 异常 信息 。 代 
码 清单 3-5 展 示 了 一 些 日 志 函 数 签 名 的 使 用 实例 。 


代码 清单 3-5 ”Android 的 各 种 日 志 记 录 函 数 


// Log a message at DEBUG log level 
Log.d(TAG, "Current question index: $currentIndex") 


try { 


val question - questionBank[currentIndex] 

) catch (ex: ArrayIndexOutOfBoundsException) { 
// Log a message at ERROR log level, along with an exception stack trac 
Log.e(TAG, "Index was out of bounds", ex) 


3.8 HRAJ: 禁止 一 题 多 答 
答 完 某 道 题 ， 就 禁 掉 那 道 题 对 应 的 按钮 ， 防 止 用 户 一 题 多 答 ，。 


3.9 ”挑战 练习 : 答题 评分 


用 户 答 完全 部 题 后 ， 显 示 一 个 toast 消 息 ， 给 出 百分比 形式 的 评分 。 


1 


第 4 半 UI 状态 的 保存 与 恢复 


适时 使 用 备 选 资源 ，Android 做 得 不 错 。 但 是 ， 设 备 旋转 导致 activity 销 
毁 与 新 建 有 时 也 令 人 头疼 ， 比 如 ， 设 备 旋转 后 ，GeoQnuiz 应 用 将 回 到 第 


—3É fl 


要 修复 这 个 bug， 旋 转 后 新 建 的 MainActivity 需 要 知道 currentIndex 
变量 的 原 值 。 显 然 ， 在 设备 运行 中 发 生 配 置 变更 时 ， 比 如 设备 旋转 ， 需 
要 想 个 办 法 保存 以 前 的 数据 。 


本 章 ， 我 们 将 学 习 使 用 ViewMode1 保 存 UI 数 据 ， 修 复 GeoQuiz 应 用 的 UI 
状态 丢失 人 缺陷。 此 外 ， 还 会 学 习 使 用 Android 的 实例 状态 保留 机 制 解决 
一 个 不 易 发 现 但 同样 严重 的 问题 一 一 进程 消亡 导致 的 UI 状态 丢失 。 


4.41 5| AViewModel/K& si 


稍 后 我 们 会 在 GeoQuiz 项 目 里 添加 ViewModel 类 。 这 个 类 来 自 一 个 叫 
lifecycle-extensionsfJAndroid Jetpack 库 ， 本 书后 续 还 会 使 用 一 些 
其 他 Jetpack 库 〈 详 见 4.5 节 ) 。 要 使 用 ViewMode1 类 ， 首 先 需 要 将 它 添加 
到 项 目 依赖 列表 里 。 


项 目 依 赖 保存 在 一 个 叫 build.gradle 的 文件 里 (前 面 说 过 ，Gradle 是 一 个 
Android 构 建 工 具 ) 。 在 项 目 工 具 窗 口中 ， 先 切换 至 Android 视 角 模 式 ， 
再 展开 Gradle scripts 区 查看 其 内 容 。 可 以 看 到 ，GeoQuiz 项 目 有 两 个 
build.gradle 文 件 : 一 个 用 于 整体 项 目 ， 一 个 用 于 应 用 模块 。 打 开 应 用 模 
块 里 的 puild.gradle 文 件 ， 应 该 看 到 类 似 代码 清单 4-1 所 示 的 内 容 。 


代码 清单 4-1 Gradle 项 目 依赖 (app/build.gradle) 


apply plugin: 'com.android.application' 


apply plugin: 'kotlin-android' 
apply plugin: 'kotlin-android-extensions' 


android ( 


} 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 
implementation 'androidx.appcompat:appcompat:1.0.0-beta01' 


依赖 代码 区 第 一 行 表明 ， 当 前 项 目 依赖 的 所 有 ,jar 文件 都 在 libs 目 录 里 。 
其 他 行列 出 的 依赖 库 都 是 在 创建 项 目 时 根据 选 定 的 配置 自动 引入 的 。 


Gradle 文 持 指 定 新 依赖 ， 之 后 ， 在 应 用 编译 时 ， 它 会 帮 你 找到 并 下 载 引 
入 。 你 只 要 给 出 准确 的 库 描述 ， 剩 下 的 交 给 Gradle 就 可 以 了 。 


如 代码 清单 4-2 所 示 ， 在 app/build.gradle 文 件 里 添加 1ifecycle- 
extensions 依 赖 。 顺 便 说 一 句 ， 新 加 依赖 代码 具体 放 在 dependencies 区 
s qe 但 最 好 保持 整齐 一 致 的 风格 ， 以 便 以 后 继续 添加 
BTA RARAS o 


代码 清单 4-2 添加 1ifecycle-extensions 依 赖 
Capp/build.gradle ) 


dependencies { 


implementation 'androidx.constraintlayout:constraintlayout:1.1.2' 


implementation 'androidx.lifecycle:lifecycle-extensions:2.0.0' 


如 图 4-1 所 示 ，build.gradle 文 件 有 变化 后 ，Android Studio 会 提醒 你 同步 
XL 


Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly, — Sync Now 


Kl4-1 Gradle 同 步 提示 


这 个 同步 就 是 基于 文件 修改 内 容 ， 让 Gradle 下 载 或 删除 依赖 库 后 重新 编 
译 。 要 发 起 同步 ， 可 直接 点 击 同步 提醒 劳 的 Sync Now 按 钮 ， 或 者 选择 


File > Sync Project with Gradle Files 荣 单项 。 


4.2 ”添加 ViewModel 


现在 ， 是 时 候 添加 ViewModel 了 。ViewModel 与 某 种 特殊 用 户 屏 相关 
联 ， 非 常 适 合 存 管 那些 处 理 屏 显 数据 的 逻辑 。ViewModel 持 有 模型 对 
象 ， 能 够 “加 工 美 化 > 模型 层 对 象 。 你 不 想 让 模型 对 象 做 的 数据 显示 相关 
的 事情 ，ViewMode1 有 能 力 来 处 理 。 使 用 ViewMode1， 可 以 把 所 有 要 显 
人 统一 格式 化 加 工 处 理 供 其 他 对 象 获 


ViewMode1 在 androidx.lifecycle 包 里 。 从 名 字 可 以 看 出 ， 这 个 包 里 是 那些 
包括 生命 周期 感知 类 部 件 在 内 的 生命 周期 相关 的 API。 生 命 周 期 感知 类 
部 件 监视 像 activity 这 样 的 其 他 部 件 ， 午 握 着 它们 的 生命 周期 状态 。 


Google 创 建 androidx.lifecycle 包 的 目的 是 让 activity 生 命 周 期 管理 更 容易 些 
《除了 activity 还 有 哪些 生命 周期 管理 ， 请 留意 本 书后 续 章 

节 ) 。LiveData 是 Android 的 又 一 个 生命 周期 感知 类 部 件 ， 第 11 章 将 介 

绍 。 男 外 ， 第 25 章 还 会 学 习 如 何 开 发 一 个 生命 周期 感知 类 部 件 。 


现在 来 创建 一 个 名 为 QuizViewMode1 的 ViewMode1 子 类 。 在 项 目 工具 窗 
口中 ， 右 键 单 击 com.bignerdranch.android.geoquiz 包 ， 选 择 New > Kotlin 
File/Class 菜 单项 。 输 入 QuizViewModel 作 为 类 名 ，Kind 类 型 从 下 拉 列 表 
里 选 Class。 


如 代码 清单 4-3 所 示 ， 在 QuizViewModel.kt 中 ， 添 加 init 代 码 块 并 履 羔 
onCleared( ) 函 数 ， 男 外 再 调用 日 志 函 数 记录 QuizViewMode1l 实 例 的 创 
建 和 销毁 。 


代码 清单 4-3 ”创建 ViewModel 类 (QuizViewModel.kt) 


private const val TAG = "QuizViewModel" 


class QuizViewModel : ViewModel() ( 


init { 
Log.d(TAG, "ViewModel instance created") 
j 


override fun onCleared() ( 
super .onCleared() 
Log.d(TAG, "ViewModel instance about to be destroyed") 


onCleared() 函 数 的 调用 恰好 在 ViewMode1 被 销毁 之 前 。 这 里 适合 做 一 
些 善 后 清理 工作 ， 比 如 解 绑 某 个 数据 源 。 当 前 ， 这 里 只 是 记 

录 ViewMode1 何 时 被 销毁 ， 以 方便 观察 其 生命 周期 〈 同 第 3 重 探 

过 MainActivity 的 生命 周期 时 采用 的 方式 一 样 〉。 


现在 ， 打 开 MainActivity.kt， 如 代码 清单 4-4 所 示 ， 在 onCreate(...) 
里 ， 将 MainActivity 和 QuizViewModel 实 例 关 联 起 来 。 


代码 清单 4-4 访问 ViewModel (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 
Re fun onCreate(savedInstanceState: Bundle?) { 
setcontentvi ew R. layoutcackivetycmein) 
val provider: ViewModelProvider = ViewModelProviders.of(this) 


val quizViewModel - provider.get(QuizViewModel::class.java) 
Log.d(TAG, "Got a QuizViewModel: $quizViewModel") 


trueButton - findViewById(R.id.true button) 


以 上 代码 中 ，ViewModelProviders 类 (留意 “Providers” 的 复数 形式 ) 
提供 了 ViewModelProvider 类 的 实例 。 调 

用 ViewModelProviders.of(this) 的 作用 是 创建 并 返回 一 个 关联 了 
MainActivity 的 ViewModelProvider 实 例 。 


另外 ，ViewModelProvider (留意 “Provider” 的 单数 形式 ) 会 提供 
ViewMode1 实 例 给 MainActivity。 调 

用 provider.get(QuizVvViewModel: :class.java) 会 返回 一 

个 QuizViewModel 实 例 。 现 实 开 发 中 ， 你 经 常会 看 到 这 样 的 链 式 调用 : 


ViewModelProviders.of(this).get(QuizViewModel::class.java) 


ViewModelProvider 是 个 注册 领 用 ViewMode1 的 地 方 。 

在 MainActivity 首 次 访问 QuizViewModel 时 ，ViewModelProvider 会 
创建 并 返回 一 个 QuizViewModel 新 实例 。 在 设备 配置 改变 之 

后 ，MainActivity 再 次 访问 QuizViewMode1 对 象 时 ， 它 返回 的 是 之 前 
创建 的 QuizViewModel。 在 MainActivity 完 成 使 命 销毁 时 (比如 用 户 
按 了 回 退 键 ) ，ViewModel-Activity 这 对 好 朋友 也 就 从 内 存 里 抹 掉 
Ta 


4.2.1 ViewModel/t &j /4] 3j] E; ViewModelProvider 


如 第 3 章 所 述 ，activity 一 直 在 运行 、 暂 停 、 停 止 和 不 存在 这 四 种 状态 间 
转换 。activity 何 时 被 销毁 有 两 种 情况 : 一 是 用 户 结束 使 用 activity， 二 是 
因 设 备 配置 改变 时 的 系统 销毁 。 


一 般 来 讲 ， 当 用 户 结束 使 用 activity 时 ， 都 希望 重 置 应 用 的 UI 状态 。 而 当 
用 户 旋 转 activity 时 ， 他 们 又 希望 旋转 前 后 UI 状 态 保持 一 致 。 


通过 检查 activity 的 isFinishing 属 性 可 以 知道 哪 一 场景 正在 上 演 。 如 果 
isFinishing 属 性 值 是 true， 那 么 activity 正 在 被 销毁 ， 因 为 用 户 结 束 
使 用 当前 activity 了 《比如 按 了 回 退 键 ， 或 者 从 概览 屏 消除 了 应 用 卡 

片 ) 。 如 果 isFinishing 属 性 值 是 false，activity 则 正在 被 系统 销毁 ， 
因为 设备 配置 改变 了 。 


不 过 ， 有 了 ViewModel， 当 isFinishing 属 性 值 是 false 时 ， 检 查 
isFinishing 状 态 并 保存 UI 状态 就 不 需要 手动 处 理 了 。 我 们 可 以 

用 ViewMode1l 把 UI 状态 保存 在 内 存 里 ， 以 应 对 设备 配置 的 改 

变 。ViewModel1 的 生命 周期 更 符合 用 户 的 预期 : 设备 配置 发 生变 化 数据 
也 不 会 丢失 ， 只 有 在 关联 activity 结 束 使 命 时 才 会 与 之 一 起 销毁 。 


在 代码 清单 4-4 中 ， 一 个 ViewMode1 实 例 和 一 个 activity 生 命 周期 关联 上 
了 。 这 时 ， 我 们 可 以 说 ， 该 ViewMode1 和 其 关联 activity 的 生命 周期 同步 
了 。 这 意味 着 ， 不 管 天 联 activity 处 于 什么 状态 ， 该 ViewMode1 会 一 直 保 
留 在 内 存 里 ， 直 到 关联 activity 因 结束 使 用 被 销毁 。 如 网 4-2 所 示 ， 一 旦 
关联 activity 因 结束 使 用 被 销毁 〈 比 如 用 户 按 了 回 退 键 》， 对 应 的 
ViewMode1 实 例 也 会 随 之 销毁 。 


MainActivity.onDestroy() 被 调用 


Activity.isFinishing? 


P Em 
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图 4-2 QuizViewModelfllMainActivity;b ii — 2% 


这 意味 着 ， 像 设备 旋转 这 样 的 配置 改变 发 生 时 ，ViewMode1 留 在 了 内 存 
里 。 设 备 配置 改变 时 ，activity 实 例 被 销毁 并 重建 ， 但 其 关联 的 
ViewModel 仍 留 在 内 存 里 。 以 MainActivity 和 QuizViewMode1 为 参考 
对 象 ， 图 4-3 展 示 了 这 一 过 程 。 


旋转 之 前 旋转 期 间 旋转 之 后 


New 
MainActivity 


QuizViewModel QuizViewModel QuizViewModel 


图 4-3 MainActivity 和 QuizViewModel 经 历 设 备 旋转 


为 动态 观察 此 现象 ， 我 们 运行 GeoQuiz 应 用 。 在 Logcat 中 的 下 拉 列 表 里 
选择 Edit Filter Configuration 创 建 一 个 新 过 滤器 。 如 图 4-4 所 示 ， 在 Log 
Tag 处 输入 QuizViewModel | MainActivity (管道 符 | 隔 开 的 两 个 类 名 ) ， 
控制 只 显示 这 两 个 类 的 标签 日 志 。 将 过 滤器 命名 为 
ViewModelAndActivity《〈 命 名 自 定 ， 合 适 即 可 ) 后 ， 点 击 OK 确 认 。 


e e Create New Logcat Filter 


am = Filter Name: ViewModelAndActivity| 
USN ee SIMI Aes] Specify one or several filtering parameters: 


Log Tag: Q~ QuizViewModel|MainActivity Regex 
Log Message: Qv Regex 
Package Name: Q7 Regex 
PID: 

Log Level: Verbose x 


Cancel Ex 
图 4-4 ”过滤 显 示 QuizViewMode1L 和 MainActivity 日 志 


现在 查看 日 志 。 在 onCreate(. . .) 函 数 里 ，MainActivity 在 首次 启动 
并 请 求 ViewMode1 时 ， 一 个 新 的 QuizViewMode1 实 例 被 创建 了 。 这 可 以 
在 日 志 截 图 4-5 中 清楚 看 到 。 


Logcat v= 


il Emulator Pixel,2,API.28 Androli »  com.bignerdranch.android.geoqui: v Verbose v Or U Regex ViewModelAndActivity M 


2019-02-13 21:33:06.481 23961-23961/com, bignerdranch,android.geoquiz D/Mainkctivity: onCreate(Bundle?) called 

2019-02-13 21:33:06,594 23961-23961/com. bignerdranch. android, geoquiz D/QuizViewlodel; Viewodel instance created 

34 2019-02-13 21:33:06,594 23961-23961/com, bignerdranch. android, geoquiz D/MainActivity: Got a QuizViewlodel: com, bignerdranch android, geoquiz QuizViewodel@6293db0 
2019-02-13 21:33:06,598 23961-23961/com, bignerdranch. android, geoquiz D/MainActivity: onStart() called 

2019-02-13 21:33:06,599 23961-23961/com. bignerdranch, android, geoquiz D/MainActivity: onResume() called 


图 4-5 QuizviewMode1 实 例 创 建 了 


旋转 设备 。 如 图 4-6 的 日 志和 截图 所 示 ，activity 被 销毁 了 ， 

而 QuizViewMode1 得 以 保留 。 旋 转 后 ， 新 的 MainActivity 实 例 被 创 
建 ， 它 要 求 关联 一 个 QuizViewModel。 既 然 原 QuizViewModel 仍 保留 
在 内 存 里 ， 那 么 ViewModelProvider 就 直接 返回 它 ， 而 不 是 再 去 新 建 


一 个 。 


Logcat $- 


ib Emulator Pixel 2 APL28 Andro v  com.bignerdranch.android.geoqui; v Verbose v Q' E Regex — VieuModelhndActivity Y 
i 2019-02-13 21:33:06,481 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity; onCreate(Bundle?) called 

2019-02-13 21:33:06,594 23961-23961/com, bignerdranch, android, geoquiz D/QuizViewNodel: Viewlodel instance created 
34 2019-02-13 21:33:06,594 23961-23961/con, bignerdranch. android, geoquiz D/MainActivity: Got a QuizViewModel: com bignerdranch, android, geoquiz.QuizViewodel@6293db0 


2019-02-13 21:33:06,598 23961-23961/com, bignerdranch, android. geoquiz D/MainActivity: onStart() called 

2019-02-13 21:33:06,599 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onResume() called 

2019-02-13 21:38:15,585 23961-23961/com bignerdranch, android. geoquiz D/MainActivity: onPause() called 

2019-02-13 21:38:15,508 23961-23961/com, bignerdranch, android, geoquiz D/Mainkctlvity: onStopl) called 

2019-02-13 21:38:15,591 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onDestroy() called 

2019-02-13 21:38:15,613 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onCreate(Bundle?) called 

2019-02-13 21:38:15,641 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: Got a QuizViewodel: com bignerdranch, android, geoquiz, QuizViewodet@6293db0 
2019-02-13 21:38:15,644 23961-23961/com, bignerdranch, android. geoquiz D/MainActivity: onStart() called 

qp 2019-02-13 21:38:15,645 23961-23961/con binerdranch.android.geoquiz D/Maindctivity: onResune() called 


图 4-6 ”MainActivity 销 毁 又 重建 ，QuizViewMode1 得 以 保留 


最 后 ， 点 击 回 退 键 。 如 图 4-7 的 日 志 截 图 所 

示 ，QuizVviewModel.onCleared() 被 调用 了 ， 这 表明 QuizViewMode1 
实例 即将 被 销毁 。 很 快 ，QuizVviewMode1 和 MainActivity 都 被 销毁 
fs 


Logcat $- 


HM EmulatorPixe|2 AP|28 Andro) v — comignerdrenchandroigeoqu; » Verbose Y Q' E Regex ViewModelAndActivity M 


moei emei guumumus qum imum imum m emnt 


2019-02-13 21:33:06,599 23961-23961/com, bignerdranch, android, geoquiz D/MeinActivity: onResune() called 

2019-02-13 21:38:15,585 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onPause() called 

2019-02-13 21:38:15,588 23961-23961/com. bignerdranch. android, geoquiz D/MainActivity: onStop() called 

2019-02-13 21:38:15,591 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onDestroy() called 

2019-02-13 21:38:15,613 23961-23961/com, bignerdranch, android, geoquiz D/Mainkctivity: onCreate(Bundle?) called 

2019-02-13 21:38:15,641 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: Got a QuizViewlodel: com bignerdranch, android, geoquiz, Qui2Viewodelg6293db0 

2019-02-13 21:38:15,644 23961-23961/com, bignerdranch, android, geoquiz D/MoinActivity onStart() called 

2019-02-13 21:30:15,645 23961-23961/com, bignerdranch, android, geoquiz D/MainActivity: onResume() called 

2019-02-13 21:45:04,573 23961-23961/con, bignerdranch, android, qeoquiz D/MainActivity: onPause() called 

2019-02-13 21:45:04,727 23961-23961/com, bignerdranch, android, geoquiz D/Mainkctivitys onStop() called 

Q 2019-02-13 21:45:04,731 23961-23961/com, bignerdranch, android, geoquiz D/QuizViewodel: Viewlodel instance about to be destroyed 
2019-02-13 21:45:04,732 23961-23961/con, bignerdranch android, geoquiz D/MainActivity: onDestroy() called 


2019-12-13 21:33:06,590 23961-2396/ con bgnerdranch android. geoquiz Dinkctivity' Start) called = 
外 


Ji 


» 


图 4-7 QuizViewModel 和 MainActivity 都 被 销毁 了 


QuizViewModel 和 MainActivity 的 关系 是 单 回 的 。 某 个 activity 会 引用 
其 关联 ViewMode1， 反 过 来 则 不 行 。 一 个 ViewMode1 绝 不 能 引用 activity 
或 view， 否 则 会 引发 内 存 泄漏 。 


当 茶 个 对 象 强 引用 另 一 个 要 被 销毁 的 对 象 时 ， 和 内 存 泄 漏 就 会 发 生 。 这 样 
的 强 引 用 会 阻止 垃圾 回收 器 从 内 存 里 清理 对 象 。 设 备 配置 改变 融 来 的 内 
存 泄 漏 是 常见 问题 。 强 引用 和 垃圾 回收 知识 超出 了 本 书 讨论 范围 ， 如 果 
不 熟悉 这 些 概念 ， 建 议 去 阅读 Kotlin 或 Java 相 关 参 考 资料 。 


设备 旋转 时 ，ViewModel1 实 例 留 在 了 内 存 里 ， 而 原始 activity 实 例 已 经 被 
销毁 。 如 果 某 个 ViewModel 强 引用 着 原始 activity 实 例 ， 则 会 市 来 两 个 问 
题 : 首先 ， 原 始 activity 实 例 无 法 从 内 存 里 清除 ， 因 而 它 泄漏 了 ; 其 次 ， 
该 ViewMode1 引 用 的 是 一 个 失效 activity。 因 此 ， 如 果 它 想 更 新 失效 
activity 的 视图 ， 则 会 扫 出 IllegalStateException 异 常 。 


4.2.2 ”向 ViewModel 添 加 数据 


现在 ， 是 时 候 解决 GeoQuiz 应 用 在 设备 旋转 时 暴露 的 问题 了 。 既 

然 QuizViewMode1l 不 会 像 MainActivity 那 样 在 设备 旋转 时 被 销毁 ， 我 
们 就 可 以 把 UI 状态 数据 保存 在 QuizViewModel 实 例 里 ， 不 用 再 担心 数据 
Fee ie 

首先 ， 把 question 和 当前 index 数 据 ， 以 及 它们 的 相关 逻辑 代码 复制 

到 ViewModel 里 。 如 代码 清单 4-5 所 示 ， 从 MainActivity 里 前 

切 currentIndex 和 questionBank 属 性 。 


代码 清单 4-5 ”从 activity 里 移 除 模型 数据 〈MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


然后 ， 如 代码 清单 4-6 所 示 ， 粘 贴 currentIndex 和 questionBank 属 性 
#QuizViewModel. 


代码 清单 4-6 ”粘贴 模型 数据 至 
QuizViewModel (QuizViewModel.kt) 


class QuizViewModel : ViewModel() ( 


— var currentIndex = 0 


private val questionBank - listOf( 
Question(R.string.question australia, true), 
Question(R.string.question oceans, true), 
Question(R.string.question mideast, false), 
Question(R.string.question africa, false), 
Question(R.string.question americas, true), 
Question(R.string.question asia, true) 


删除 currentIndex 属 性 的 private 修 饰 符 ， 让 MainActivity 这 样 的 外 
部 类 能 够 访问 其 属性 值 。questionBank 的 private 访 问 修 饰 符 保留 不 
动 一 一 MainActivity 会 调用 添加 到 QuizVviewMode1 里 的 函数 和 计算 局 
性 ， 而 不 是 直接 访问 questionBank。 另 外 ，init 和 onCleared() 日 志 
记录 代码 没 用 了 ， 顺 手 删 除 它们 。 


接着 ， 在 QuizViewModel 里 ， 添 加 地 理 知识 问题 出 题 函数 ， 以 及 返回 当 
前 题 干 内 容 和 答案 的 计算 属性 ， 如 代码 清单 4-7 所 示 。 


代码 清单 4-7 向 QuizViewModel 里 添加 业务 逻辑 
(QuizViewModel.kt) 


class QuizViewModel : ViewModel() ( 


var currentIndex - 0 


private val questionBank = listOf( 


) 


val currentQuestionAnswer: Boolean 
get() = questionBank[currentIndex].answer 


val currentQuestionText: Int 
get() = questionBank[currentIndex].textResId 


fun moveToNext() { 
currentIndex = (currentIndex + 1) % questionBank.size 


} 


之 前 我 们 次 过 ，ViewMode1 会 保存 关联 用 户 界面 所 需 数据 ， 并 整理 格式 
化 这 些 数 据 ， 以 方便 其 他 对 象 取 用 。 这 样 一 来 ， 束 可 以 把 屏 硕 展现 迎 辑 
从 activity 里 删除 ， 证 其 “ 瘦 丑 ”了 。 尽 可 能 轻 量化 activity 有 很 多 好 处 : 不 
用 担心 activity 里 的 逻辑 受 其 生命 周期 的 潜在 有 影响 了 ; 各 司 其 职 ， 让 

activity 只 人 负责 用 户 界面 上 的 显示 内 容 ， 不 考虑 数据 该 如 何 显 示 的 逻辑 。 


不 过 ，updateQuestion() 和 checkAnswer(Boolean) 函 数 还 是 会 留 
在 MainActivity 里 。 稍 后 ， 我 们 会 更 新 它们 以 调用 QuizViewModel 里 
新 添加 的 计算 属性 。 将 它们 留 在 MainActivity 里 会 让 activity 代 码 组 织 
得 更 有 条 理 。 


接 下 来 ， 如 代码 清单 4-8 所 示 ， 添 加 一 个 惰性 初始 化 属性 来 保存 
与 MainActivity 关 联 的 QuizViewModel 实 例 。 


代码 清单 4-8 惰性 初始 化 QuizViewModel (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private val quizViewModel: QuizViewModel by lazy { 
ViewModelProviders.of(this) .get(QuizViewModel: : class. java) 


} 


override fun onCreate(savedInstanceState: Bundle?) { 


使 用 by 1azy 关 键 字 ， 可 以 确保 quizViewMode1 属 性 是 val 类 型 ， 而 不 
是 var 类 型 。 这 人 简直 太 棒 了 ， 因 为 只 在 activity 实 例 对 象 被 创建 后 ， 才 需 
要 获取 和 保存 QuizViewModel， 也 就 是 说 ，quizViewMode1l 一 次 只 应 
该 赋 一 个 值 。 


更 为 重要 的 是 ， 使 用 了 by lazy 关 键 字 ，quizViewMode1 的 计算 和 赋值 
只 在 首次 获取 quizViewModel 时 才 会 发 生 。 这 很 有 用 ， 因 为 只 有 

在 Activity.onCreate(...) 被 调用 后 ， 才 能 安全 地 获取 到 一 

个 ViewMode1。 如 果 在 Activity.onCreate(...) 被 调用 之 前 调 
HiViewModelProviders.of(this).get(QuizViewModel::class.ja 
应 用 则 会 抛 出 ILlegalStateException 异 名。 


最 后 ， 如 代码 清单 4-9 所 示 ， 更 新 MainActivity 人 代码， 
与 QuizViewMode1 交 互 ， 显 示 地 理 知 识 问题 和 答案 。 


代码 清单 4-9 ”通过 QuizViewMode1l 更 新 题 干 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


nextButton.setOnClickListener ( 


quizViewModel .moveToNext () 
updateQuestion() 
} 


j 
private fun updateQuestion() ( 


— —wvai-questioenTextResId—-—questionBank|currentIndex]-textResId 


val questionTextResId - quizViewModel.currentQuestionText 
questionTextView.setText(questionTextResId) 


} 


private fun checkAnswer(userAnswer: Boolean) { 


——valeerrectAnswer—=questionBankfeurrentindex} answer 


val correctAnswer = quizViewModel.currentQuestionAnswer 


运行 GeoQuiz 应 用 ， 点 击 NEXT 按 钮 ， 旋 转 设备 或 模拟 器 。 不 管 如 何 旋 
转 ，MainActivity 都 能 记 住 当前 题目 。 开 心 一 下 吧 ， 设 备 旋转 丢失 UI 


状态 数据 的 问题 终于 解决 了 。 
然而 ， 开 心 只 是 暂时 的 ， 因 为 还 有 另 一 个 不 容易 发 现 的 问题 要 对 付 。 


4.3 进程 销毁 时 保存 数据 


不 管用 户 想 或 不 想 ， 并 不 是 只 在 配置 改变 时 ， 操 作 系 统 才 要 销毁 某 个 
activity。 每 个 应 用 都 有 自己 的 进程 《更 具体 地 讲 ， 是 一 个 Linux 进 
程 ) ， 其 包含 一 个 执行 UI 工 作 的 单线 程 ， 以 及 保存 对 象 的 一 小 块 内 存 。 


用 户 离 开 当 前 应 用 一 会 儿 或 Android 需 要 回收 内 存 时 ， 应 用 的 进程 都 会 
被 操作 系统 销毁 。 应 用 进程 被 销毁 后 ， 进 程 内 存 里 存储 的 所 有 对 象 目 然 
也 就 随 之 被 销毁 了 (Android 应 用 进程 详 见 第 23 章 ) 。 


相 比 其 他 进程 ， 有 前 台 《〈 和 运行 状态 ) 或 可 见 〈 和 暂停 状态 ) activity 进 程 的 
优先 级 更 高 。 需 要 释放 资源 时 ，Android 操 作 系 统 的 首选 目标 是 低 优先 


级 进程 。 用 户 体验 至 上 ， 理 论 上 ， 操 作 系统 不 会 “ 杀 和 死 ?" 壳 有 可 见 activity 
的 进程 。 如 果真 的 出 现 这 种 情况 ， 则 说 明 设 备 出 现 了 大 故障 《既然 如 
此 ， 用 户 应 用 被 “ 杀 死 ”的 事 已 经 不 重要 了 ) 。 


但 是 ， 集 止 的 activity 被 “条 死 * 是 很 正常 的 事 ， 例 如 ， 用 户 按 了 主屏 大 
键 ， 然 后 播放 视频 或 玩 起 游戏 。 在 这 种 情况 下 ， 你 的 应 用 进程 可 能 会 被 
销毁 。 


(本 书 撰写 时 ， 在 低 内 存 状 态 下 ，Android 会 直接 从 内 存 清除 整个 应 用 
进程 ， 连 带 应 用 的 所 有 activity。 目 前 ，Android 还 做 不 到 只 销毁 单个 


activity. ) 


当 操 作 系统 销毁 应 用 进程 时 ， 内 存 中 的 任何 应 用 activity 和 ViewModel 都 
会 被 清除 。 操 作 系统 做 起 销毁 的 事 室 不 留情 ， 不 会 去 调用 任何 activity 
或 ViewMode1 的 生命 周期 回调 函数 。 


那么 ， 该 如 何 保存 UI 状态 数据 ， 并 用 它 重 建新 的 activity， 让 用 户 察觉 不 
到 activity 经 历 过 “生死 ? 呢 ? 一 个 办 法 是 将 数据 保存 在 保留 实例 状态 

(saved instance state) 里 。 保 留 实例 状态 是 操作 系统 临时 存放 在 activity 
之 外 某 个 地 方 的 一 段 数据 。 通 过 鹤 芒 
Activity.onSaveInstanceState(Bundle) 的 方式 ， 你 可 以 把 数据 添 
加 到 保留 实例 状态 里 。 


只 要 在 未 结束 使 用 的 activity 进 入 停止 状态 时 比如 用 户 授 了 Home 按 
钮 ， 启 动 另 一 个 应 用 时 ) ， 操 作 系 统 都 会 调 

用 Activity.onSsaveInstanceState(Bundle)。 这 个 时 间 点 很 重要 ， 
因为 停止 的 activity 会 被 标记 为 kil11able。 如 果 应 用 进程 因 低 优先 级 
被 * 杀 死 ”， 那 么 ， 你 大 可 放心 
Activity.onSaveInstanceState(Bundle) 肯 定 已 被 调用 过 。 


onSaveInstanceState(Bundle) 的 默认 实现 要 求 所 有 activity 视 图 将 自 
冉 状 态 数 据 保 存在 Bundle 对 象 中 。Bundle 是 存储 字符 串 键 与 特定 类 型 
值 之 间 映 射 关 系 〈 键 值 对 ) 的 一 种 结构 。 


之 前 你 已 见 过 这 样 的 Bundle。 如 下 列 代码 所 示 ， 它 作为 参数 被 传 入 


onCreate(Bundle?): 


override fun onCreate(savedInstanceState: Bundle?) { 


super.onCreate(savedInstanceState) 
} 


fd mionCreate(Bundle?) KAHT, Kit Hactivity tý 
onCreate(Bundle?) 函 数 ， 并 传 入 收 到 的 bundle。 在 超 类 代码 实现 里 ， 
通过 取出 保存 的 视图 状态 数据 ，activity 的 视图 层级 结构 得 以 重建 。 


43.1 %tionSaveInstanceState(Bundle) 函数 

Hy Hj HionSaveInstanceState(Bundle) MAY — LEA HER TELE 
bundle'#, %&/afEonCreate (Bundle?) eh BF Ay [Al ik LEA, Mb FL 
旋转 问题 时 ， 将 采用 这 种 方式 保存 currentIndex 变 量 值 。 


首先 ， 打 开 MainActivity.kt 文 件 ， 新 增 一 个 常量 作为 将 要 存储 在 bundle 中 
的 键 值 对 的 键 ， 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 ”新 增 键 值 对 的 键 (MainActivity.kt) 


private const val TAG = "MainActivity" 
private const val KEY INDEX = "index" 


class MainActivity : AppCompatActivity() { 


} 


‘kia, %2#ionSaveInstanceState(Bundle) M2, LAMIA 335 ds E 
值 作为 键 ， 将 currentIndex 变 量 值 保存 到 bundle 中 ， 如 代码 清单 4-11 所 
Zo 


代码 清单 4-11 JEionSavelInstanceState(...)rPQZj 
(MainActivity.kt) 


override fun onPause() { 


} 


override fun onSaveInstanceState(savedInstanceState: Bundle) ( 
super.onSaveInstanceState(savedInstanceState) 
Log.i(TAG, "onSaveInstanceState") 
savedInstanceState.putInt(KEY INDEX,  quizViewModel.currentIndex) 


} 


override fun onStop() { 


} 


最 后 ， 在 onCreate(Bundle?) 函 数 中 确认 是 人 否 成 功 获取 该 数值 。 如 果 
获取 成 功 ， 就 将 它 赋值 给 变量 currentIndex; 如 果 bundle 里 不 存 

在 index 键 对 应 的 值 ， 或 者 Bundle 对 象 是 nul1， 就 将 currentIndex 的 
值 设 为 69， 如 代码 清单 4-12 所 示 。 


代码 清单 4-12 在 onCreate(Bundle?) 函 数 中 检查 存储 的 bundle 信 
A CMainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d(TAG, "onCreate(Bundle?) called") 
setContentView(R.layout.activity main) 


val currentIndex = savedInstanceState?.getInt(KEY INDEX, 0) ?: 6 
quizViewModel.currentIndex = currentIndex 


onCreate 接 受 传 入 可 空 值 bundle。 这 是 因为 用 户 首次 启动 的 activity 新 实 
例 是 没有 状态 的 ， 自 然 对 应 的 bundle 为 空 。 当 设备 旋转 或 进程 被 销毁 后 
重建 应 用 activity 时 ，Bundle 对 象 就 有 值 了 。 此 时 的 bundle 会 保存 你 

在 onSaveInstanceState(Bundle) 里 添加 的 键 值 对 。 另 外 ，Bund1le 对 
象 里 也 可 能 包含 系统 框架 添加 的 额外 信息 ， 比 如 某 个 EditText 的 内 容 或 
者 其 他 基本 UI 部 件 的 状态 。 


旋转 设备 很 好 测试 ， 低 内 存 状况 也 很 好 测试 。 羔 目 试 试 吧 。 


在 人 鲁 件 设 备 或 模拟 器 上 的 应 用 列表 中 找到 “设置 ”(Settings ) 图 标 。 启 动 
Settings， 找 到 默认 隐藏 的 Developer options 选 项 。 如 果 用 的 是 实体 设 
备 ， 你 可 能 已 在 学 习 第 2 音 时 局 用 了 它 ; 如 果 用 的 是 模拟 器 (或 者 还 没 
启用 Developer options 选 项 ) ， 请 选择 System — About emulated 

device (或 System > About Tablet/Phone) ， 人 然后 向 下 滑 屏 ， 找 到 并 连 
续 点 击 Build number 七 次 。 


在 看 到 “You are now a developer!” 消 息 时 ， 按 回 退 键 回 到 系统 设置 界 

面 ， 向 下 滑 屏 找到 Developer options 选 项 〈 可 能 需要 展开 Advanced 区 
域 ) 。 如 图 4-8 所 示 ， 在 Developer options 选 项 界面 ， 你 会 看 到 很 多 设置 
选项 。 向 下 滚动 找到 Apps 区 域 ， 打 开 Don't keep activities 选 项 。 


9:00 WE d B 100% 
€ Developer options a 
Apps 
Don't keep activities 
Destroy every activity as soon as the user © 
leaves it 


Background process limit 
Standard limit 


Background check 


Always show crash dialog 
Show dialog every time an app crashes 


Show background ANRs 
Display App Not Responding dialog for 
background apps 


Show notification channel warnings 


Displays on-screen warning when an 
app posts a notification without a valid 
channel 


<q o BD 


图 4-8 ”启用 Don't keep activities Jyi 


ABE. WAAR, mip Eee BSS EAA activity. HAA 
日 志 可 知 ， 就 像 Android 操 作 系统 回收 内 存 那样 ， 俘 止 的 activity 被 系统 
销毁 了 。 另 外 ， 我 们 在 日 志 里 也 看 到 onSsaveInstanceSstate(Bundle) 
被 调用 了 一 一 这 就 是 希望 所 在 。 


重新 运行 应 用 《使 用 设备 或 模拟 器 上 的 应 用 列表 ) ， 验 证 activity 状 态 是 
个 如 期 得 到 保存 。 可 以 看 到 ，GeoQuiz 恢 复 后 显示 了 应 用 关闭 前 的 那 让 


题 。 这 一 刻 ， 你 应 该 夸 伟 上 自己 了 。 


测试 完毕 ， 记 得 关闭 Don't keep activities 选 项 ， 否 则 将 导致 系统 和 应 用 出 
现 性 能 问题 。 和 点 击 主屏 幕 键 不 一 样 的 是 ， 点 击 回 退 键 后 ， 无 论 是 否 局 
用 Don't keep activities 选 项 ， 系 统 总 是 会 销毁 当前 的 activity。 点 击 回 退 键 
相当 于 告诉 系统 “用 户 不 再 需要 使 用 当前 的 activity f". 


4.3.2 ”保留 实例 状态 与 activity 记 录 
应 用 activity 或 进程 被 销毁 后 ， 保 存在 onSsaveInstanceSstate(Bundle) 


中 的 数据 该 如 何 幸 免 于 难 呢 ? 调用 该 函数 时 ， 用 户 数据 随即 被 保存 
到 Bundle 对 象 中 ， 然 后 操作 系统 将 这 个 Bundle 对 象 放 入 activity 记 录 
HH, 


为 便于 理解 activity 记 录 ， 我 们 增加 一 个 暂 存 状态 (stashed state) 到 
activity 生 命 周期 ， 如 图 4-9 所 示 。 


(activity 实 例 已 
销毁 ， 实 例 状态 


已 保存 ) 启动 完成 或 被 
| oe 


onDestroy() 


(sede ire) 


oko 


onCreate(...) 


用 户 重启 activity, 
进程 重新 启动 


"d onStop() 


| | 
用 户 可 见 ”用户 不 可 见 


暂停 
(用 户 可 见 ) 


进入 前 台 离开 前 台 
l l 
onResume()  onPause() 


运行 
(前 台 活 动 中 ) 


图 4-9 ”完整 的 activity 生 命 周期 


Activity 被 暂 存 后 ，Activity 对 象 将 不 再 存在 ， 但 操作 系统 会 将 activity 记 
录 对 象 保 存 起 来 。 这 样 ， 在 需要 恢复 activity 时 ， 操 作 系 统 可 以 使 用 暂 存 
的 activity 记 录 重 新 激活 activity。 


注意 ，activity 进 入 和 暂 存 状态 并 不 一 定 需要 调用 onDestroy() 函 数 。 不 
过 ，onStop() 和 onSaveInstanceState(Bundle) 是 两 个 可 靠 的 函数 
(除非 设备 出 现 重 大 故障 ) 。 因 而 ， 常 见 的 做 法 是 ， 窟 盖 
onSaveInstanceState( Bundle) HX, 在 Bundle 对 象 中 ， 保 存 当前 
activity 小 的 或 暂 存 状态 的 数据 | 覆盖 onSstop( ) 函 数 ， 保 存 永久 性 数 
据 ， 比 如 用 户 编 辑 的 文字 等 。 调 用 完 onSstop() 函 数 后 ，activity 随 时 会 
被 系统 销毁 ， 所 以 用 它 保存 永久 性 数据 。 


那么 暂 存 的 activity 记 录 到 底 可 以 保留 多 久 呢 ?” 前 面 说 过 ， 用 户 按 了 回 退 
键 后 ， 系 统 会 彻底 销毁 当前 的 activity。 此 时 ， 暂 存 的 activity 记 录 会 同时 
被 清除 。 此 外 ， 如 果 系 统 重启 ， 那 么 暂 存 的 activity 记 录 也 会 被 清除 。 

《 按 回 退 键 结束 activity 意 味 痢 什么 ， 请 参阅 3.4.2 人 。 ) 


4.4 ViewModel 与 保存 实例 状态 


无 论 是 进程 销毁 还 是 设备 配置 改变 ， 保 留 实例 状态 都 能 保存 activity 记 录 
以 防止 信息 丢失 。 初 次 启动 某 个 activity 时 ， 保 留 实例 状态 bundle 还 
是 null， 设 备 旋转 时 ， 操 作 系 统 会 调用 该 activity 的 
onSaveInstanceSstate(Bundle) 函 数 ， 然 后 将 保存 在 bundle 里 的 数据 
传递 给 onCreate(Bundle? ) 函数。 


保留 实例 状态 既 能 应 对 进程 销毁 ， 也 无 惧 设 备 配 置 改 变 ， 那 还 要 
ViewModel FEE? 实际 上 ， 对 于 GeoQuiz 这 样 的 简单 应 用 ， 保 留 实例 
状态 就 够 用 了 。 


GeoQnuiz 应 用 有 便 编 码 的 轻 量 数据 融 够 用 了 ， 大 多 数 应 用 则 不 行 。 如 

今 ， 它 们 大 多 要 从 数据 库 、 互 联网 ， 甚 至 同时 从 这 两 个 渠道 动态 获取 数 

据 。 这 些 数据 获取 行为 是 异步 的 ， 通 常 比较 慢 ， 会 耗费 宝 贯 的 电力 和 网 

如 有 果 和 activity 的 生命 周期 绑 定 ， 这 些 行 为 不 仅 效率 低 ， 还 容易 
H o 


这 方面 的 工作 如 果 交 给 ViewModel 人 处 理 ， 那 将 是 它 最 擅长 的 事情 。 在 第 
11 章 和 第 24 音 ， 你 将 看 到 它 出 色 的 表现 。 例 如 ， 即 使 设备 配置 改 

变 ，ViewMode1 也 能 轻松 处 理 继续 下 载 的 任务 。 对 于 因 配 置 改 变 要 保存 
的 数据 ， 它 也 能 轻松 搞定 ， 无 须 加 载 到 宝贵 的 内 存 里 。 


不 过 ， 你 知道 的 ， 如 果 用 户 终 结 使 用 activity，ViewModel 就 会 被 清除 。 
所 以 ， 当 遇 到 进程 消亡 的 场景 ，ViewMode1 就 不 好 使 了 。 这 时 候 ， 该 保 
留 实例 状态 上 场 了 。 但 保留 实例 状态 也 有 其 局 限 性 。 因 为 保留 实例 状态 
数据 是 要 序列 化 到 磁盘 的 ， 所 以 应 避免 用 它 保存 任何 大 而 复杂 的 对 象 。 


本 书 撰 写 时 ，Android 团 队 正 努力 改善 ViewMode1 开 发 使 用 体验 ， 已 发 
布 l1ifecycle-viewmode1l-savedstate 这 个 新 库 ， 让 ViewMode1 在 进 
程 消亡 时 也 能 保存 状态 数据 。 这 样 ，ViewModel 搭 配 保留 实例 状态 应 用 
就 没 那 么 困难 了 。 


现在 ， 再 讨论 哪 种 方案 更 好 就 没 必要 了 。 聪 明 的 开发 人 员 会 用 好 它们 ， 
让 它们 各 上 自发 挥 所 长 ， 和 谐 共 处 。 


使 用 保留 实例 状态 保存 少量 必需 信息 以 重建 UI 状 态 〈 例 如 ，GeoQnuiz 应 
用 的 currentIndex) 。 使 用 ViewModel 保 存 的 更 丰富 的 数据 ， 可 以 快 
速 方便 地 取 回 来 填充 UI， 以 应 对 设备 配置 改变 。 如 果 activity 是 在 进程 销 
毁 后 重建 ， 那 就 借助 保留 实例 状态 先 创 建 ViewMode1， 从 而 达 

到 ViewModel 和 activity 从 未 失效 的 效果 。 


本 书 握 写 时 ， 应 用 activity 重 建 是 因 进 程 销 毁 还 是 设备 配置 改变 一 时 还 没 
有 很 多 的 判别 方法 。 为 什么 要 搞 清 楚 呢 ?如 果 是 设备 配置 改变 ， 那 

么 ViewMode1l 还 会 待 在 内 存 里 。 这 种 情况 下 ， 如 果 还 用 保留 实例 状态 来 
更 新 ViewModel， 就 是 让 应 用 做 不 必要 的 事 ， 是 多 此 一 举 。 如 琳 还 因此 
让 用 户 等 待 ， 或 耗费 电力 这 样 的 宝 贯 资 源 ， 那 么 本 来 就 多 此 一 举 的 事 更 


古 个 大 问题 了 。 


一 个 解决 办 法 是 让 ViewModel 聪 明 一 点 儿 。 如 果 担 心 设置 ViewModel 值 
是 多 此 一 举 的 事 ， 那 就 首先 检查 其 数据 是 否 可 用 ， 然 后 再 决定 要 不 要 抓 
取 和 更 新 其 余数 据 : 


class SomeFancyViewModel : ViewModel() { 


fun setCurrentIndex(index: Int) { 
if (index != currentIndex) { 
currentIndex = index 
// Load current question from database 


保留 实例 状态 和 ViewModel 都 不 是 长 期 存储 解决 方案 。 如 果 应 用 需要 长 
久 和 存储 数据 ， 且 完全 不 担心 activity 状 态 ， 那 么 请 考虑 使 用 持久 化 存储 方 
案 。 本 书 会 带 你 学 习 尘 握 两 种 本 地 持久 化 存储 方法 : 数据 库 〈 详 见 第 11 
7&) 和 shared preference 〈 详 见 第 26 章 ) 。shared preference 适 合 保存 轻 量 
数据 。 本 地 数据 库 更 适合 保存 大 量 复杂 数据 。 除 了 本 地 存储 外 ， 你 还 可 
的 第 24 章 会 介绍 如 何 从 Web 服 务 器 上 获取 


如 果 GeoQuiz 应 用 需要 大 量 题目 ， 那 么 ， 相 比 在 ViewMode1 里 便 编 码 ， 


用 数据 库 或 web 服务 咒 来 保存 题目 数据 应 该 更 好 。 另 外 ， 因 为 GeoQuiz 
应 用 用 到 的 题目 都 是 不 变 的 常量 ， 所 以 就 更 有 理由 让 这 些 数据 保持 与 

activity 生 命 周 期 状态 无 天 了 。 不 过 ， 读 取 数 据 库 要 比 读 取 内 存 慢 很 多 。 
所 以 ， 束 GeoQuiz 应 用 场景 来 说 ， 最 好 的 方案 束 是 使 用 ViewModel， 加 
载 要 展示 的 UI 数据 并 将 其 保存 在 内 存 里 ， 同 时 控制 UI 进行 展现 。 


本 章 通过 正确 判别 设备 配置 改变 和 进程 销毁 并 加 以 处 理解 决 了 GeoQnuiz 
的 状态 丢失 问题 。 下 一 章 将 学 习 如 何 使 用 Android Studio 调 试 工具 解决 开 
发 过 程 可 能 出 现 的 应 用 相关 问题 。 


45 深入 学 习 : Jetpack、AndroidX 与 架构 组 件 


ViewModel 所 在 的 lifecycle-extensions 库 是 Android Jetpack 
Components (简称 Jetpack〉 库 包 的 一 部 分 。Jetpack 是 Google 官 方 出 品 的 
一 套 开 发 库 ， 目 的 是 让 Android 开 发 更 轻松 些 。 


所 有 Jetpack 库 都 位 于 androidx 打 头 的 包 里 ， 所 以 我 们 会 听 到 Jetpack 和 
AndroidX 两 种 不 同 术语 叫 法 。 


如 图 4-10 所 示 ， 之 前 我 们 在 创建 新 项 目 时 ， 都 默认 色 选 了 Use AndroidX 
artifacts 选 项 。 如 同 创建 GeoQnuiz 项 目 那样 ， 该 选项 几乎 每 次 都 必 选 ， 这 
样 Android Studio 会 添加 一 些 基 本 的 Jetpack 库 ， 让 应 用 默认 使 用 它们 。 


050 Create New Project 


Configure your project 


Name 


My Application 


Package name 


ES ‘com.bignerdranch.android.myapplication | 


Save location 


 füsers/boardnerDesktop/MyApplication s 


Language 
| Kotlin Y| 


Empty Activity Minimum API level 


AP 21: Android 5.0 (Lollipop) v 


() Your app will run on approximately 85.0% of devices, 
Help me choose 


J This project will support instant apps 
Use AndroidX artifacts 


Creates a new empty activity 


| Cancel | Previous | Next 


图 4-10 ”添加 Jetpack 支 持 库 


Jetpack 库 分 为 四 大 类 : foundation、architecture、behavior 和 UI。 
architecture 类 Jetpack 库 还 有 一 个 常见 名 字 叫 architecture 
component。ViewMode1 就 是 一 种 架构 组 件 。 后 续 章 节 还 会 介绍 其 他 几 
个 重要 架构 组 件 ， 它 们 是 Room 《〈 详 见 第 11 章 ) 、Data Binding 〈 详 见 第 
19%) 和 WorkManager 〈 详 见 第 27 章 ) 。 


此 外 ， 本 书 还 会 介绍 一 些 foundation 类 的 Jetpack 库 ， 它 们 是 

AppCompat 〈 详 见 第 14 章 ) 、Test〈 详 见 第 20 章 ) 和 Android KTX ( 详 
见 第 26 章 ) 。 第 27 章 还 会 介绍 Notification 这 个 行为 Jetpack 库 。 另 外 ， 还 
有 一 些 UI Jetpack 库 ， 比 如 Fragment〈 详 见 第 8 章 ) 和 Layout 〈 详 见 第 9 章 
和 第 10 章 ) 。 


有 些 Jetpack 组 件 是 新 开发 的 ， 有 些 早 束 有 了 ， 之 前 都 是 放 在 一 个 叫 文 持 
库 的 大 包 里 。 如 果 以 前 用 过 支持 库 ， 你 应 该 知道 ， 现 在 都 用 
Jetpack CAndroidXO 版 本 的 蔡 代 库 了 。 


46 深入 学 习 : 解决 问题 要 彻底 


有 的 开发 人 员 直 接 禁止 应 用 屏 旋转 ， 以 此 解决 设备 配置 改变 带 来 的 UI 状 
态 丢失 问题 。 应 用 不 支持 旋转 ，UI 状 态 就 不 会 丢失 了 ， 不 是 吗 ? 没 错 ， 
但 精 粒 的 是 ， 这 样 粗 其 的 解决 方案 会 带 来 其 他 问题 。 这 虽然 解决 了 设备 
RAE HM, PSC A, TOE SAR 
定 能 发 现 。 


首先 ， 应 用 运行 时 ， 还 会 发 生 其 他 设备 配置 改变 ， 比 如 窗口 大 小 调整 和 
夜间 模式 切换 和 等。 当然， 你 仍然 可 以 捕获 并 忽略 它们 ， 或 者 有 和 针对 性 地 
进行 处 理 。 但 这 上 坚 都 是 很 糟糕 的 开发 实践 ， 也 就 是 访 ， 你 共用 了 东 坚 系 
统 特性 ， 让 它 无 法 根据 设备 配置 改变 自动 选择 最 佳 适 配 资 源 了 。 


其 次 ， 强 行 处 理 配置 改变 或 共用 旋转 也 不 能 解决 进程 销 蝶 问 题 。 
GOR SB RE DADA SCRE BRE BORE BE, FF ALU GEIR A UR THEE. ATE Aci 


还 应 该 防范 处 理 其 他 设备 配置 改变 和 进程 销毁 。 学 习 了 ViewMode1I 和 保 
留 实例 状态 的 知识 ， 你 现在 应 该 知道 怎么 做 了 。 


忆 之 ， 解 决 UI 状态 丢失 问题 不 能 简单 粗暴 地 一 蔡 了 之 。 这 里 算 
醒 ， 和 希望 你 以 后 开发 实战 时 警惕 此 类 问题 。 


AW En wA e N yD 
535 5 Android 应 用 的 调试 
本 章 将 讲解 如 何 处 理应 用 的 bug， 介 绍 如 何 使 用 LogCat、Android Lint 以 


及 Android Studio 内 置 的 代码 调试 器 。 


为 练习 调试 ， 我 们 先 搞 点 破坏 。 打 开 MainActivity.kt 文 件 ， 
在 onCreate(Bundle?) 函 数 中 ， 注 释 挥 questionTextView 变 量 赋值 的 
那 行 代码 ， 如 代码 清单 5-1 所 示 。 


代码 清单 5-1 注释 掉 一 行 关键 代码 (MainActivity.kt) 
override fun onCreate(savedInstanceState: Bundle?) ( 


trueButton - findViewById(R.id.true button) 
falseButton - findViewById(R.id.false button) 


nextButton - findViewById(R.id.next button) 
// questionTextView - findViewById(R.id.question text view) 


运行 GeoQuiz 应 用 ， 看 看 会 发 生 什么 。 应 用 立即 骨 尝 了 了。 


在 Android Pie (API 28) 之 前 的 版 本 系统 上 ， 你 会 看 到 错误 信息 提示 应 
用 毅 涡 了 。 而 在 运行 Android Pie 的 设备 上 ， 观 察 屏幕 ， 只 能 看 到 应 用 一 
内 而 过 就 消失 了 ， 什 么 提示 都 没有 。 这 种 情况 下 ， 请 在 局 动 界面 再 次 局 
eye o RK, MAUR, Kee SIAS-1 PANE epe H 


b diu i 


GeoQuiz keeps stopping 


© App info 


x Close app 


图 5-1 GeoQuiz)y FH iq yt f 

WIR, BOTTA MARA AT it. WRAAE, BE BOKHJAUSDALAS BBE 
帮助 解决 问题 。 

5.1 异常 与 栈 跟 路 


该 会 看 到 整 片 红色 的 异常 或 错误 信息 ， 如 图 5-2 所 示 。 这 就 是 标准 的 
AndroidRuntime 异 常 信 息 报 告 。 


Logeat ġ - 


H Emulator Pixel 2 APL 2! v | Nodebuggable processes v| Error vv Q Regex — Show only selected appli: v 


8 2019-02-21 13:42:03,209 5908-5908/1 E/AndroidRuntine; FATAL EXCEPTION: main 
Process: com Dignerdranch. android, geoquiz, PID; 5908 
E: java, lang. RuntineException; Unable to start activity ConponentInfo(con,bignerdranch, android. geoquiz/ com. bignerdranch, android, geoquiz 
MainActivity}; kotlin.UninitializedPropertyAccessException: lateinit property questionTextView has not been initialized 
1 at android, app, ActivityThread, performLaunchActivity(ActivityThread, java:2913) 
i at android, app. ActivityThread, handleLaunchActivity(ActivityThread, java: 3048) 
at android, app. servertransact ion, LaunchActivityltem. execute(LaunchActivityltem, java: 78) 
3 at android, app, servertransact ion. TransactionExecutor. executeCal backs (TransactionExecutor, java: 108) 
at android, app, servertransact ion, TransactionExecutor, execute(TransactionExecutor, java: 68) 
B at android, app. ActivityThread$H, handleMessage(ActivityThread, java: 1808) 
at android, os. Handler, dispatchMessage(tiand er. java; 106) 
q at android.os. Looper. loop(Looper. java: 193) 
at android, app. ActivityThread, main (ActivityThread, ava:6669) <1 internal call 
P at con, android, internal.os.RuntimeInit$MethodAndArgsCaller, run (RuntimeTnit., java:493) 
! at con.android, internal, os. ZygoteInit main(ZygoteInit, java: 858) 
Caused by: kotlin.UninitializedPropertyAccessException: lateinit property questionTextView has not been initialized 
at com. bignerdranch, android, geoquiz.MainActivity, updateQuestion(MainActivity, kt;90) 
n at con.bignerdranch, android, geoquiz.MainActivity, onCreate(MainActivity, kt:54) 
at android, app. Activity. performCreate(Activity java: 7136) 


ik at android, app. Activity. performCreate(Activity. java: 7127) 
at android, app, Instrumentation, callActivityOnCreate(Instrunentat ion, java: 1271) 
) at android, app. ActivityThread. performLaunchActivity(ActivityThread, java:2893) «8 more...» <1 internal call» <2 mere...» 
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图 5-2 LogCat'H fi 75 E FR ER IER 


如 果 看 不 到 ， 可 试 着 选择 LogCat 的 No Filters 过 滤 项 。 男 外 ， 如 果 觉 得 信 
息 太 多 ， 看 不 过 来 ， 可 以 调整 Log Level] 为 Error， 让 系统 只 输出 严重 问 
题 日 志 。 还 可 以 使 用 搜索 功能 ， 比 如 搜 “FATAL EXCEPTION”, 5SLHBé EL 
接 定 位 让 应 用 骨 演 的 异常 。 


该 腊 肖 报告 首先 给 出 最 高 层级 的 腊 第 及 其 栈 跟踪 ,然后 是 导致 该 异常 的 
异常 及 其 栈 跟踪 。 如 此 不 断奶 滴 ， 直 到 找到 一 个 没有 具体 原因 的 异常 。 


因为 我 们 编写 的 是 Kotlin 代 码 ， 所 以 看 到 java.lang 异 常会 感觉 很 奇怪 。 实 
际 上 ， 对 于 Android 应 用 编译 ，Kotlin 代 码 会 被 编译 为 和 Java 代 码 同样 的 
低级 字 节 人 码 。 在 此 过 程 中 ， 许 多 Kotlin 异 常会 通过 类 型 别名 Ctype- 
aliasing) 和 java.lang 异 党 映射 对 应 起 来 。kot1lin.RuntimeException 
是 kotlin.UninitializedPropertyAccessException 的 超 类 ， 在 


Android 上 ， 其 和 java.lang.RuntimeException 相 对 应 。 


在 我 们 编写 的 大 部 分 代码 中 ， 最 后 一 个 没 给 出 具体 原因 的 异常 往往 就 是 
关注 点 。 这 里 ， 没 有 具体 原因 的 异常 

是 kotlin.UninitializedPropertyAccessException。 紧 接着 该 异 
党 语句 的 一 行 就 是 其 栈 跟 踊 信 息 的 第 一 行 。 从 该 行 可 以 看 出 发 生 异 常 的 
类 和 函数 以 及 它 所 在 的 源 文 件 及 代码 行 号 。 点 击 此 处 链接 ，Android 
Studio 会 自动 跳 转 到 源 代 码 的 对 应 代码 行 。 


Android Studio 定 位 的 这 行 代 人 码 是 questionTextView 变 量 

在 updateQuestion() 函 数 中 的 首次 使 用 。 名 

为 UninitializedPropertyAccessException 的 异常 暗示 了 问题 所 
在 ， 即 变量 没有 初始 化 。 


为 修正 该 问题 ， 取 消 对 变量 questionTextView 赋 值 语句 的 注释 ， 如 代 
码 清单 5-2 所 示 。 


代码 清单 5-2 ”取消 注释 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


trueButton = findViewById(R.id.true button) 
falseButton = findViewById(R.id.false button) 
nextButton = findViewById(R.id.next_button) 


— Ft 


一 questionTextView = findViewById(R.id.question text view) 


} 


WEZE, WE Logat Si gun NP I OER A BS — 
P E 。 这 里 是 问题 发 生 的 地 方 ， 也 是 查找 解决 方案 的 最 
佳 起 点 。 


如 果 发 生 应 用 贿 尝 的 设备 没有 与 计算 机 连接 ， 日 志 信 息 也 不 会 全 部 丢 
失 。 设 备 会 将 最 近 的 日 志保 存 到 日 志文 件 中 。 日 志文 件 的 内 容 长 度 及 保 
留 的 时 间 取 决 于 具体 的 设备 ， 不 过 ， 获 取 十 分 钟 之 内 产生 的 日 志 信 息 通 
常 是 有 保证 的 。 只 要 将 设备 连 上 计算 机 ， 在 Devices 视 图 里 选择 所 用 设 
备 ，LogCat 会 自动 打开 并 显示 日 志文 件 保存 的 内 容 。 


5.1.1 诊断 应 用 异常 
即使 出 了 问题 ， 应 用 也 不 一 定 会 崩溃 。 某 些 时 候 ， 应 用 只 是 出 现 了 运行 
异常 。 例 如 ， 每 次 点 击 NEXT 按 钮 时 ， 应 用 都 训 无 反应 。 这 就 是 一 个 非 
朋 尝 型 的 应 用 运行 异常 。 


在 MainActivity.kt 中 ， 修 改 nextButton 监 听 器 代码 ， 注 释 掉 
currentIndex 变 量 递增 的 语句 ， 如 代码 清单 5-3 所 示 。 


代码 清单 5-3” 漏 抒 一 行 关键 代码 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


nextButton.setOnClickListener ( 
// quizViewModel.moveToNext() 


updateQuestion() 
j 


运行 GeoQuiz 应 用 ， 点 击 NEXT 按 钮 。 可 以 看 到 ， 应 用 无 响应 。 

这 个 问题 要 比 上 一 个 琼 手 。 它 没有 抛 出 异常 ， 所 以 ， 解 决 起 来 不 像 前 面 
跟踪 追溯 并 消除 异常 那么 简单 。 有 了 前 面 的 经 验 ， 这 里 可 以 推测 出 导致 
该 问题 的 两 个 因素 : 


e currentIndex 变 量 值 没 有 改变 ; 
e updateQuestion() 函数 没 被 调用 。 


如 果实 在 没有 头绪 ， 则 需要 设法 跟踪 并 找 出 问题 所 在 。 在 接 下 来 的 几 市 
里 ， 我 们 将 学 习 两 种 跟踪 问题 的 方法 : 


e. 记录 栈 跟踪 的 诊断 性 日 志 ; 
。 利用 调试 器 设置 断 点 调试 。 


5.1.2 ”记录 栈 跟 踪 日 志 


在 MainActivity 中 ， 为 updateQuestion() 函 数 添 加 日 志 输 出 语句 ， 
如 代码 清单 5-4 所 示 。 


代码 清单 5-4 方便 实用 的 调试 方式 (MainActivity.kt) 


private fun updateQuestion() { 
Log.d(TAG, "Updating question text", Exception()) 


val questionTextResId = quizViewModel.currentQuestionText 
questionTextView. setText (questionTextResId) 


如 同 前 面 UninitializedPropertyAccessException 的 异 

常 ，Log.d(String，String，Throwable) 函 数 记录 并 输出 整个 栈 跟 
踪 日 志 。 这 样 ， 就 可 以 很 容易 看 出 updateQuestion() 函 数 在 哪些 地 方 
被 调用 了 。 


作为 参数 传 入 Log.d(String，String，Throwable) 函 数 的 异常 不 一 
定 就 是 已 捕获 的 抛 出 异常 。 你 可 以 创建 一 个 全 新 的 Exception， 把 它 作 
a 异常 对 象 传 入 该 水 数 。 借 此 ， 我 们 可 以 得 到 异常 发 生 位 置 的 
记录 报告 。 


运行 GeoQuiz 应 用 ， 点 击 NEXT 按 钮 ， 然 后 在 LogCat 中 查看 输出 结果 ， 
如 图 5-3 所 示 。 


Logcat ġ - 
T} Emulator Pixel,2_API_2¢ v com.bignerdranch.android v Debug v Q E Regex — Show only selected applic: v 
i 2019-02-21 13:51:56,134 6385-6385/com, bignerdranch, android. geoquiz D/MainActivity: Updating question text 
java. lang, Exception 

it at com bignerdranch, android, geoquiz MainActivity, updateQuestion(MainActivity, kt:89) 

at com bignerdranch, android, geoqui2 MainActivity, access$updateQuestion(MainActivity, kt: 16) 
人 at com,bignerdranch, android, geoquiz, vere aaa onClick(MainActivity, kt:51) 
| at android, view. View, performClick(\/ic 

anos n pero y. Java:6574) 
5 at android, view, View, access$3100(View, java: 77¢ 

at android, view. View$PerformClick, nis 15885 
5 at android os Handler. hand\eCat bac Handler jata:87 

at android. os, Handler, dispatchMessage (Hand er, java:99) 
q at android. os, Looper, loop(Loop r java:103) 

at android, app.ActivityThread.main(ActivityThread, java:6669) <1 internal cal 
a at con android, internal. os, RuntimeInit$MethodAndArgsCaller, run(Runtimelnit, java:493) 


at com android, internal. os, ZygoteInit main (2ygoteInit, java: 850) 


图 5-3 ”输出 结果 


栈 跟 踪 日 志 的 第 一 行 即 调 用 异常 记录 函数 的 地 方 。 紧 接着 的 两 行 表 

明 ，updateQuestion() 函 数 是 在 onClick(View) 实 现 里 被 调用 的 。 点 
击 该 行 链接 跳 转 至 注释 挥 的 问题 索引 递增 代码 行 。 暂 时 不 要 修正 ， 下 一 
节 还 会 使 用 设置 断 点 调试 的 方法 重新 得 找 该 问题 。 


记录 栈 跟 踩 日 志 虽 然 是 个 强大 的 工具 ， 但 也 存在 缺陷 。 比 如 ， 大 量 的 日 
志 输 出 很 容易 导致 LogCat 窗 口 信息 混乱 难 读 。 此 外 ， 通 过 阅读 详细 直 日 
的 栈 跟 踩 日 志 并 分 析 代 码 意 图 ， 竞 争 对 手 可 以 轻易 唱 守 我 们 的 创意 。 
另外， 既然 有 可 能 从 栈 跟 中 日 志 看 出 代码 的 真实 意图 ， 那 么 在 Stack 
Overflow 网 站 或 者 Big Nerd Ranch 论 坛 上 求助 时 ， 附 上 一 上段 栈 跟踪 日 志 
往往 有 助 于 解决 问题 。 如 果 需 要 这 样 做 ， 你 可 以 直接 从 LogCat 中 复制 并 
粘贴 日 志 内 容 。 

继续 学 习 之 前 ， 先 删除 日 志 记 录 代 码 ， 如 代码 清单 5-5 所 示 。 


代码 清单 5-5 再见 ， 老 朋友 CMainActivity.kO 


private fun updateQuestion() { 


Log.dCTAG; "Updati on te E tion) 


val questionTextResId = quizViewModel.currentQuestionText 
questionTextView.setText(questionTextResId) 


} 


5.13 ”设置 断 点 


要 使 用 Android Studio 自 带 调试 器 调试 上 一 节 中 的 问题 ， 首 先 要 

在 updateQuestion() 中 设置 断 点 ， 以 确认 该 函数 是 否 被 调用 。 断 点 会 
在 断 点 设置 行 的 前 一 行 处 停止 代码 执行 ， 然 后 我 们 可 以 逐 行 检查 代码 ， 
看 看 接 下 来 到 底 发 生 了 什么 。 


在 MainActivity.kt 文 件 中 ， 找 到 updateQuestion() 函 数 ， 点 击 第 一 行 代 
码 左边 的 灰色 栏 区 域 。 可 以 看 到 ， 灰 色 栏 上 出 现 了 一 个 圆 点 。 这 就 是 已 
设置 的 一 处 断 点 ， 如 图 5-4 所 示 。 把 光标 放 在 想 打 断 点 的 那 一 行 ， 使 用 
Command+F8 (Ctrl+F8) 可 以 启用 和 禁用 断 点 。 


private fun updateQuestion() { 
Q val questionTextResId - quizViewModel.currentQuestionText 
questionTextView. setText (questionTextResId) 


图 5-4 已 设置 的 一 处 断 点 


为 启用 代码 调试 器 并 触发 已 设置 的 断 点 ， 我 们 需要 调试 运行 而 不 是 直接 
运行 应 用 。 如 图 5-5 所 示 ， 要 调试 运行 应 用 ， 点 击 Run 按 钮 芳 边 的 Debug 
按钮 ， 或 选择 Run 5 Debug ‘app’ 菜单 项 。 设 备 会 报告 说 正在 等 待 调试 
器 加 载 ， 然 后 继续 运行 


Attach Debugger to 


Debug ‘app Android Process 


^ |a ap ~| > & Mm & 
图 5-5 ”调试 应 用 按钮 


某 些 时 候 ， 你 可 能 不 想 重 新 运行 应 用 而 直接 调试 运行 中 的 应 用 。 如 图 5- 
5 所 示 ， 点 击 Attach Debugger to Android Process 按 钮 ， 或 选择 Run — 
Attach to process.…. 沫 单项 ， 你 可 以 加 载 调 试 右 调试 运行 中 的 应 用 。 在 弹 
出 的 对 话 框 里 ， 选 择 应 用 进程 后 点 击 OK 按 钮 ， 调 试 器 就 加 载 到 运行 的 
应 用 了 。 注 意 ， 调 试 器 加 载 后 ， 当 前 运行 代码 执行 到 的 断 点 才 会 激活 ， 
之 前 打 的 断 点 都 会 被 忽略 。 


我 们 打算 从 头 开 始 调试 GeoQuiz 应 用 ， 上 所 以 使 用 JS Debug ‘app’ 菜单 项 。 
应 用 局 动 并 加 载 调试 器 运行 后 ， 束 会 暂停 。 应 用 首先 会 调 

用 MainActivity.onCreate(Bundle?)， 该 函数 又 会 调 

用 updateQuestion() 函 数 ， 然 后 触发 断 点 。【〔 如 果 应 用 运行 之 后 才 加 
载 调 斌 器， 那么 应 用 可 能 不 会 在 断 点 处 停 下 ， 因 为 在 加 载 调试 器 之 
前 MainActivity.onCreate(Bundle?) 己 执行 完毕 。) 


如 图 5-6 所 示 ，MainActivity.kt 已 经 在 代码 编辑 区 打开 了 ， 断 点 设置 所 在 
行 的 代码 也 被 加 亮 显示 了 。 应 用 在 断 点 处 停止 运行 。 这 时 ， 由 Frames 和 
Variables 视 图 组 成 的 Debug 工 具 窗 口 出 现在 了 屏幕 确 部 。〈 如 果 Debug 工 
具 窗 口 没 有 自动 打开 ， 点 击 Android Studio 窗 口 底部 的 Debug 按 钮 即 
HJ.) 


000 ,Geo |-hrtingfendrcidfoooktDebuggingscluton GenQui] -.Jip/src/meiavcombignerdrancfantroicgeocul Maint [app] 


f GeoQulz ) i app ) src ) Le main) x Java ) bx com ) Dt blonerdranch ) a androld ) B geogule) fl alnActvty Mt) eT) heheh Mhe ev vO5 6855 HQ! 
f 不 ae， a 
E 5 | 59 Y, Dune E woos C Rg ? Ti 
$ ü a’ 
83l > override fun ondestroy() ( 
中 super, onpestroy | 
85 Log.d(7AG, msg: "onDestroy() called") - 
) 
val questionTex TUM Id = quizViewlodel. currentQuestionText 
| 9 QuestlonTertiLey, setText(questionTextRes]d) 
yu ) 
| 
93 private fun checkAnswer(userAnswers Boolean) { 
Q vol Correcthnswer = quizViewfodel.currantQuestionAnswer 
MalnActvty ^ update uestion() 
| Debug: "ap. à - 
pb ip oge omer AL h 20% 8% a 
ii enin so : 
| p "main" 68n pop’ "ain": RUNNING surety S this » (MainActivity81!188) 
| 一 VCache = nul 
A updateQuestion:89, Manic m ornertrano Aite i D > falseButton = (AppCormpatButtong!11/2) "android appcompat widget AppCempatButton(4(2cd7c YFED. C... 0,0-0,0... Viow 
gg Create, Maie (omtinednchanduó (907) a metButton = (AppCompatButtong11143} ndrkagpoonpat widget AppCompatBton(e7B05 VED, C... 00/. Vow 
7. gets iy _ > f questionTectVew = (AppCorpatTaVieugtt4t) "android appcompat widget AppCompatTeitViw(bBefóBa VED... io 
: 自 perform Cregte;7127, Activity (android apo) -P Y quizViowModel8delogato  (SynchronizedLazyimple 145] "combgnerdranch android gtoquiz QuizViewModeleg7cP 
eal ActivityOnCreate: 1271, instrumentation (android.apo] ® v SP quizViewModel = (Qui2VieuModelottt46) q 
ye perlormLaunehictivty 2893, Activity Thread (androi.gpo] e 4 curentnden = 0 i 
© d handle eunchActiity:3048, ActivityThread (android aon) > ^E questionBank = (ArraystArrayListQU?t91) size «6 i 
S execute;78, LaunchActivityltem (android.app.servertransaction) ^f mBagOtTags = (ConcurrentHahMap/1102) size = 0 1 
i ? executeCallbacks:108, TransactionEXecutor (android apo servertransact 4 mCleared = false 
& | trol 0, TransactionExecutor (android app servertransaction) > {shadows Kass. = (Class 610706] “lass com.bignerdranch android geoquiz Quiz ViewModa .. Navigate 
handlNessaoe:!R08. AethulvThread fandtaid annt di ^t shadows monitor, = 1988129681 
ETOO Moml Bii ret cm Profior P :Run DG €) Event Log 
D Grade build finished in 86 ms (4 minutes ago) 8684 LF UTF8 Git bryanDebugging-update è Cortent:<iocoriant> = B 


图 5-6 ”代码 在 断 点 处 停止 执行 


如 图 5-7 所 示 ， 使 用 Debug 工 具 窗 口 顶部 的 箭头 按钮 可 单 步 执行 应 用 代 
人 码 。 调 试 过 程 中 ， 可 以 使 用 Evaluate Expression 按 钮 按 需 执行 简单 的 
Kotlin 语 句 。 这 个 工具 很 强大 ， 应 该 利用 好 它 。 


Step Step Step Evaluate 
Resume Progranm Over Into Out Expression 


\ pebus = app n £ : Z * P 


|» Debugger [Ej Console >" = 


Frames * ~~ Threads >“ 


Stop 
~ 
ul 


© "main" $910,638 in group "main": RUNNING Y Y 
e updateQuestion:89, MainActivity (com. bignerdranch.android.geoquiz) 
Z onCreate:54, MainActivity (com.bignerdranch.android.geoquiz) 


performCreate:7136. Activitv (android.app) 
图 5-7 Debug 工具 窗口 中 的 控制 按钮 


从 栈 列 表 可 以 看 出 ，updateQuestion() 已 经 在 onCreate(Bundle?) 中 
被 调用 了 。 不 过 ， 我 们 关心 的 是 NEXT 按 钮 被 点 击 后 的 行为 。 因 此 ， 点 
击 Resume Program 按 钮 继续 。 然 后 ， 点 击 GeoQuiz 中 的 NEXT 按 钮 ， 观 察 
断 点 是 否 被 激活 并 停止 执行 代码 (应 该 如 此 )。 


既然 程序 执行 俘 在 了 断 点 处 ， 就 可 以 趁机 看 看 其 他 视图 。 变 量 视图 窗口 
(Variables) 可 以 让 我 们 观察 到 程序 中 各 对 象 的 值 。 你 应 该 可 以 看 到 
在 MainActivity 中 创建 的 变量 ， 以 及 一 个 特别 的 this 变 量 值 
CMainActivity 本 身 ) 。 


展开 this 变 量 后 可 看 到 很 多 变量 。 它 们 是 MainActivity 类 的 Activity 
超 类 、Activity 超 类 的 超 类 《〈 一 直 追 溯 到 继承 树 顶 端 ) 的 全 部 变量 。 
现在 ， 你 只 需要 关注 自己 创建 的 变量 。 


我 们 只 需 关 心 quizViewModel.currentIndex 变 量 值 。 如 图 5-8 所 示 ， 
在 变量 视图 窗口 里 癌 下 滚动 ， 先 找到 quizViewMode1， 然 后 展 
开 quizViewModel1 找 到 currentIndex。 


= Variables " 


AAA 


+ Y S this = (MainActivity@11136} 
t $ findViewCache = null 
1 falseButton = {AppCompatButton@11142} "androidx.appcompat. widget.AppCompatButton{4f2cd7c VFED..C.. snl, 0,0-0,0... View 
‘f nextButton = {AnpCompatButton@11143} "androidi.appcompat widget. AppCompatButton{fe57605 VFED..C.. „l, 0,0-0,0... View 
f questionTextView = (AppCompatTextView@11144} "androidx.appcompat.widget.AppCompatTextView{OB6f65a V.ED............ View 
"t quizViewModel$delegate = {SynichronizedLazy\mpl@11145} "com, bignerdranch android. geoquiz, QuizViewModel@97f8céf" 
^t quizViewModel = (QuizViewModel@ 11146) 

00 ‘P currentindex = 0 

“P questionBank = {Arrays$ArrayList@11194) size = 6 


图 5-8 查看 运行 时 变量 值 


变量 currentIndex 的 值 应 该 是 1， 因 为 点 击 NEXT 按 钮 会 让 它 从 6 递增 
到 1。 然 而 ， 如 图 5-8 所 示 ，currentIndex 的 值 为 8。 


在 编辑 器 工具 窗口 中 查看 代码 ， 可 以 看 

到 ，MainActivity.updateQuestion() 中 代码 只 是 根 

据 QuizViewMode1 内 容 更 新 题目 文字 。 代 码 看 上 去 没 问题 ， 那 么 问题 出 
在 哪儿 呢 ? 


为 继续 妃 得 ， 需 跳出 当前 函数 ， 看 
看 MainActivity.updateQuestion() 之 前 执行 的 是 什么 语句 。 点 击 
Step Out 按 钮 。 


查看 代码 编辑 工具 窗口 ， 我 们 现在 跳 到 了 nextButton 的 
OnClickListener 函 数 ， 正 好 是 在 updateQuestion() 函 数 被 调用 之 
后 。 真 是 相当 方便 的 调试 ， 问 题解 决 了 。 


当然 ， 不 用 调试 我 们 就 知道 ， 应 用 出 现 异常 是 因 

为 quizViewModel.moveToNext() 从 未 被 调用 (被 注释 掉 了 ) 。 接 下 
来 就 是 代码 修正 。 不 过 ， 要 修改 代码 ， 必 须 先 停止 调 斌 应用。 注意， 在 
调试 时 即使 修正 了 代码 ， 己 加 载 调试 器 运行 的 代码 还 是 旧 代 码 ， 所 以 调 
试 器 给 出 的 信息 可 能 会 误导 你 。 


停止 调试 有 以 下 两 种 方式 : 停止 程序 或 断 开 调试 器 。 要 停止 程序 ， 点 击 


图 5-7 所 示 的 Stop 按 钮 。 


回 到 代码 编辑 区 ， 如 代码 清单 5-6 所 示 ， 在 OnClickListener 函 数 中 ， 
取消 代码 注释 。 
代码 清单 5-6 取消 代码 注释 CMainActivity.kO 
override fun onCreate(savedInstancestate: Bundle?) { 
nextButton.setOnClickListener { 
= 


一 quizViewModel.moveToNext() 
updateQuestion() 


} 


至此， 我 们 答 试 了 两 种 不 同 的 代码 跟踪 调试 方法 : 


。 记录 栈 跟 踪 的 诊断 性 日 志 ; 
e 利用 调试 器 设置 断 点 调试 。 


哪 种 方法 更 好 ? 没有 肯定 的 答案 ， 它 们 各 有 所 长 。 实 际 体验 之 后 ， 或 许 
各 有 所 爱 吧 。 


栈 跟踪 记录 的 优点 是 ， 在 同一 日 志 记录 中 可 以 看 到 多 处 栈 跟 踩 信息 ; oR 
太 是 ， 必 须 学 习 如 何 添加 日 志 SET. 数 ， 重 新 编译 、 运 行 应 用 并 跟踪 排 
查 应 用 问题 。 


相对 而 言 ， 代 码 调 试 的 方法 更 为 方便 。 应 用 以 调试 模式 运行 后 ， 可 在 应 
用 运行 的 同时 ， 在 不 同 的 地 方 设 置 断 点 ， 寻 找 解 决 问题 的 线索 。 

5.2. ”Android 特有 的 调试 工具 

大 多 数 Android 恬 用 调试 和 Kotlin 应 用 调试 没什么 两 样 。 然 而 ，Android 


也 有 其 特有 的 应 用 调试 场景 ， 比 如 应 用 资源 问题 。 显 然 ，Kotlin 编 译 露 
并 不 擅长 处 理 此 类 问题 。 本 蔬 我 们 来 学 习 两 类 Android 特 有 问题 : 


Android Lint 问 题 和 R 类 问题 。 
5.2.1 ”使 用 Android Lint 


Android Lint (或 Lint〉 是 Android 应 用 代码 的 静态 分 析 器 (static 
analyzer) 。 作 为 一 个 特殊 程序 ， 它 能 在 不 运行 代码 的 情况 下 检查 代码 
HW HAX Androidi R MAAE, Android Lint 能 深入 检查 代码 ， 
找 出 编译 器 无 法 发 现 的 问题 。 大 多 数 情 况 下 ，Android Lint 检 查 出 的 问 

题 值 得 重视 。 


在 第 7 章 中 ， 我 们 会 看 到 Android Lint 对 设备 兼容 问题 的 警告 。 此 外 ， 
Android Lint 能 够 检查 定义 在 XML 文件 中 的 对 象 类 型 。 


假如 想 主动 查看 项 目 中 的 所 有 潜在 问题 ， 可 以 选择 Analyze > Inspect 
Code... 沫 单项 手动 运行 Lint。 在 被 问 及 检查 项 目的 哪 部 分 时 ， 选 择 Whole 
project. Android Studio 会 立即 运行 Lint 和 其 他 一 些 静 态 分 析 器 开始 分 析 
代码 (拼写 或 Kotlin 语 法 检查 ) 。 


检查 完毕 ， 所 有 的 潜在 问题 都 会 在 检查 工具 窗口 按 类 别 列 出 。 如 图 5-9 
所 示 ， 展 开 Android Lint 类 别 ， 可 看 到 具体 的 Lint 信 息 。 


Inspection Results: ‘Project Default' Profile on Project 'GeoC 
» (fJ Android 


Lint 26 warnings 

X n Correctness 3 wi ngs 
= 
- oO Performance irning 
= T 5 À 

Security 1 warnil 
T Usability 15 warr 
yy/ Kotlin 2 warning: 

Spelling < 


图 5-9 Lint 警告 信息 


(你 可 能 会 看 到 不 同 数 目的 Lint 和 警告 。 这 是 因为 Android 工 具 链 还 在 不 断 
进化 ， 新 的 检查 点 还 会 不 断 加 入 ， 新 的 限制 也 会 往 Android 框 架 中 添 
加 ， 甚 至 还 有 新 版 本 的 开发 工具 和 依赖 库 。) 


如 图 5-10 所 示 ， 展 开 Internationalization， 然 后 展开 其 下 的 Bidirectional 
Text， 可 以 看 到 相关 问题 更 加 详细 的 信息 。 点 击 Using left/right instead of 
start/end attributes， 来 看 看 这 个 特别 的 警示 到 底 是 什么 意思 。 


» 多 Y Android 26 warnings 


¥ Lint 26 warnings Suppress v 
à 和 > Correctness 3 warnings 
$ |f ¥ Internationalization 1 warn Using left/right instead of start/end attributes inspection 
£g LL bidirectional Text 1 warning Using light instead of start/end attributes 
Y. Using left/right instead of start/end attributes 1 warning 

te Yg activity main.xml 1 warning Using Gravity#LEFT and Gravity#RIGHT can lead to 
1 Use "end" instead of "right" to ensure correct behavior in right-to-left locales problems when a layout is rendered in locales where text flows 

» Performance 6 Warnings from right to left, Use Gravity#START and Gravity END 


instead, Similarly, in XML gravity and layout, gravity 


» Security 1 warnin 
ty warning attributes, use start rather than Left. 


> Usability 15 warnings 

> Kotlin 2Wamngs For XML attributes such as paddingLeft and 

> Spelling 4 typos layout narginLeft, use paddingStart and 
layout_narginStart. NOTE: If your minSdkVersion is less 
than 17, you should add both the older left/right attributes as 
Well as the new stert/right attributes, On older platforms, 
Where RTL is not supported and the start/right attributes are 
unknown and therefore ignored, you need the older left/right 
attributes, There is 8 separate lint check which catches that 
type of error, 


(Note; For Gravity#LEFT and Gravity#START, you can use 


these constants even when targeting older platforms, because 
tha ctart hitmacl le a eiinareat nf tha Taft hitmael 


Disable Inspection Run Inspection on ... 


妆 5:Debug G ingoection Results = 6: Logeat  z TODO Q Terminal 4 Buld — (n Profiler () Event Log 
图 5-10 Lint ið 


Lint 正 警告 你 ， 如 采 应 用 运行 设备 的 语言 是 自 右 问 左 阅读 ， 那 么 使 
人 问题 。《〈 第 17 章 会 学 习 如 何 让 应 
用 文 持 国际 化 使 用 。 


进一步 深 控 ， 可 以 知道 到 底 是 哪个 文件 、 哪 里 的 代码 有 问题 。 如 图 5-11 
所 示 ， 展 开 Using left/right instead of start/end attributes, 点击 
activity_main.xml 这 个 铬 抹 烦 的 文件 ， 人 查看 有 问题 的 代码 厂 段 。 


hspection Results: of "Project Default’ Profile on Project 'Geouiz’ Q= 


y fe) T Android 27 unn 
Lint 27 warning Suppress v 
x M Correctness 4 warnings 
if Iernationaizaton ale android: layout_height="wrap_content 
28 Bidirectional Text 1 waning android; Layout_gravity="botton| right" 
Using left/right instead of start/end attributes 1 war android: text="@string/next_button" 
te Y © activity main.xml 1 warning 
VF Uso "ond" instead of "right" to ensure correct behavior in right-to-left locales 
Performance 6 warnirig 
Security | warning 
Usability 
kotlin 2 | 
Spelling 4 typo 
E InspectionRosults = B:Logeat i TODO E Terminal 4 Build () Event Log 


图 5-11 查看 有 问题 的 代码 


双击 文件 名 下 的 警告 描述 ，reslayouUland/activity_main.xml 文 件 会 在 代 
码 编辑 器 工具 窗口 打开 ， 而 且 鼠 标 光 标 会 停 在 发 出 警告 的 那 行 代码 处 。 


<Button 
android: id="@+tid/next_button" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 


android: layout_gravity="bottom| right" 
android: text="@string/next_button" 

android: drawableEnd="@drawable/arrow_right" 
android: drawablePadding="4dp"/> 


Lint 在 意 的 地 方 是 ， 按 照 NEXT 按 钮 的 layout_gravity 属 性 设置 ， 按 钮 
会 出 现在 屏 磊 的 右 故 部 。 要 解决 这 个 问题 ， 需 将 该 属性 值 从 
bottom| right 改 为 bottom|end。 这 样 ， 如 果 设 备 语言 是 从 右 向 左 阅 
读 ， 那 么 按钮 就 会 出 现在 屏幕 的 左 底部 ， 如 代码 清单 5-7 所 示 。 


代码 清单 5-7 处 理 双向 文字 警告 


(res/layout/land/activity_main.xml ) 


<Button 
android: id="@+id/next_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 


cid Lov re Date 


android: layout_gravity="bottom|end" 
android: text="@string/next_button" 

android: drawableEnd="@drawable/arrow_right” 
android: drawablePadding="4dp"/> 


重新 运行 Lint， 确 认 刚 处 理 过 的 双 辣 文字 警告 问题 不 再 出 现在 Lint 检 查 
结果 里 。 如 网 5-12 所 示 ， 要 预览 布局 在 语言 环境 设置 为 自 右 同 左 的 设备 
上 是 什么 样 ， 在 编辑 器 工具 窗口 打开 Design 选 项 页 ， 在 Locale for 
Preview 下 拉 列 表 里 将 Default (en-us) 改 为 Preview Right to Left。 如 果 看 不 


到 Locale for Preview， 请 点 击 预 览 面板 顶部 的 >> 以 查看 更 多 预览 控制 选 
项 fe} 


$« Or Omar a 28 @ Appthaner Quete AAAA $6 人 Opole x29 (AppThemer Os fenus] ， Qm 90 à 


9 «| OH} . Edit Translations. 
V Preview Right to Left | 
Canberra is the capitol of Australia. Canberra is the capital of Australia, 
TRE mi FALSE mk 
wT) )wr 


图 5-12 ”从 左 向 右 预览 和 从 右 向 左 预览 


大 多 数 情况 下 ， 即 使 不 解决 Lint 报 出 的 问题 ， 应 用 也 能 运行 得 很 好 。 不 
过 ， 及 时 人 处理 Lint 和 警告 可 以 防 患 于 未 然 ， 或 使 应 用 的 用 户 体验 更 好 。 建 
议 认真 对 答 每 一 个 Lint 警 告 信息 ， 哪 怕 你 不 打算 处 理 它们 。 这 样 ， 你 束 
不 会 习惯 性 忽略 Lint 检 查 出 的 问题 ， 并 能 避免 应 用 将 来 出 现 严 重 问题 。 


针对 发 现 的 每 个 问题 ，Lint 工 具 都 提供 了 详细 的 信息 ， 并 给 出 了 解决 建 
议 。 作 为 练习 ， 请 仔细 查看 Lint 针 对 GeoQuiz 应 用 检查 出 的 问题 。 当 


然 ， 你 可 以 选择 忽略 ， 也 可 以 按 Lint 建 议 修正 问题 ， 或 者 直接 点 击 问题 
摘 述 面板 上 的 Suppress 按 钮 阻止 其 发 出 警告 。 在 GeoQuiz 应 用 的 后 续 开 
发 学 习 过 程 中 ， 我 们 的 策略 是 不 处 理 Lint 检 查 出 的 其 他 问题 。 


5.2.2 ”及 类 的 问题 


对 于 引用 还 未 添加 的 资源 ， 或 者 删除 仍 被 引用 的 资源 而 导致 的 编译 错 
误 ， 我 们 已 经 很 熟悉 了 。 通 常 ， 在 添加 资源 或 删除 引用 后 重新 保存 文 
ft, Android Studio 会 准确 无 误 地 重新 编译 项 目 。 


不 过 ， 资 源 编译 错误 有 时 会 一 直 存 在 或 真名 其 妙 地 出 现 。 如 果 遇 到 这 种 
情况 ， 请 尝试 如 下 操作 。 


。 重新 检查 资源 文件 中 XML 文件 的 有 效 性 


如 果 最 近 一 次 编译 时 未 生成 R.java 文 件 ， 那 么 项 目 中 资源 引用 的 地 
方 都 会 出 错 。 通 常 ， 这 是 由 某 个 布局 XML 文 件 中 的 拼写 错误 引起 
的 。 既 然 布 局 XML 文 件 有 时 无 法 得 到 有 效 校 验 ， 拼 写 错误 自然 也 
就 难以 发 现 了 。 修 正 找到 的 错误 并 重新 保存 XML 文件 ，Android 
Studio 会 生成 新 的 R.java 文 件 。 


e 清理 项 目 
选择 Build > Clean Project% mi. Android Studio 会 重新 编译 整个 
项 目 ， 消 除 错误 。 建 议 经 常 做 深度 项 目 清 理 。 

。 使 用 Gradle 同 步 项 目 
如 果 修 改 了 build.gradle 配 置 文件 ， 束 需要 同步 更 新 项 目的 编译 设 
置 。 选 择 File 2 Sync Project with Gradle Files Jii, Android 


Studio 会 使 用 正确 的 项 目 设 置 重 新 编译 项 目 。 这 会 解决 Gradle 配 置 
变更 带 来 的 问题 。 


e 运行 Android Lint 


仔细 得 看 Lint 警 告 信 息 ， 没 准 儿 就 会 有 新 发 现 。 


如 果 仍 有 资源 相关 问题 或 其 他 问题 ， 建 议 仔细 阅读 错误 提示 并 检查 布局 
文件 。 惰 乱 时 往往 找 不 出 问题 。 不 妨 冷静 一 下 ， 再 重新 查看 Android 
Lint 报 告 的 错误 和 和 警告， 或 许 束 能 找 出 代码 错误 或 拼写 输入 错误 。 


如 果 上 述 操 作 无 法 解决 问题 ， 或 过 到 其 他 Android Studio 使 用 问题 ， 还 可 
以 访问 Stack Overflow 网 站 或 本 书 论坛 求助 。 


5.3 ”挑战 练习 ; 探索 布局 检查 器 


为 了 调试 布局 文件 ， 可 使 用 布局 检查 器 以 交互 的 方式 检查 布局 文件 ， 研 
究 它 是 如 何在 屏 磋 上 演 染 显示 的 。 要 使 用 布局 检查 器 ， 首 先 在 模拟 器 上 
启动 GeoQuiz 应 用 ， 然 后 选择 Tools ^ Layout Inspector 荣 单项 。 布 局 检查 
器 沿 活 后 ， 点 击 布局 检查 器 视图 里 的 元 素 ， 就 可 以 查看 布局 属性 了 。 


5.4 ”挑战 练习 : RE Androidlt fe 7 Ht as 


应 用 如 何 使 用 Android 设 备 的 CPU 和 内 存 资源 ，Android Studio 的 性 能 分 
P 口 能 给 出 详细 报告 。 这 样 的 分 析 报 告 有 助 于 你 评估 和 优化 应 用 
性 能 表现 。 


要 查看 性 能 分 析 工 具 窗 口 ， 首 先 在 Android 设 备 或 模拟 器 上 运行 应 用 ， 
然后 选择 View > Tool Windows ”Profiler 芝 单项。 性 能 分 析 器 打开 之 
后 ， 你 就 能 看 到 按 CPU、 内 存 、 网 络 和 能 耗 等 资源 分 区 的 时 间 线 。 


点 击 茶 个 具体 资源 分 区 就 可 以 看 到 应 用 使 用 该 资源 的 详细 信息 。 在 CPU 
分 区 ， 点 击 Record 按 钮 可 以 捕获 更 多 CPU 使 用 信息 。 与 应 用 交互 记录 下 
性 能 分 析 信 息 后 ， 记 得 点 击 Stop 按 钮 集 止 记录 。 


第 6 音 


aA 


本 章 ， 我 们 为 GeoQuiz 应 用 添加 第 二 个 activity。 一 了 activity 控 制 一 屏 信 
尽 ， 新 activity 将 融 来 第 二 个 用 户 界 面 ， 方 便 用 户 偷 看 当前 问题 的 管 案 ， 
如 图 6-1 所 示 。 


第 二 个 activity 


9:00 


GeoQuiz 


Are you sure you want to do this? 


SHOW ANSWER 


图 6-1 CheatActivity 提 供 了 偷 看 答案 的 机 会 


如 果 用 户 选 择 先 看 答案 ， 然 后 返回 MainActivity 答 题 ， 则 会 收 到 一 
信息 ， 如 图 6-2 所 示 。 


9:00 am | 


GeoQuiz 


Canberra is the capital of Australia. 


TRUE FALSE 


CHEAT! 


NEXT ) 


Cheating is wrong. 


Kle-2 有 没有 偷 看 答案 ，MainActivity 都 知道 
完成 GeoQuiz 应 用 的 升级 ， 我 们 可 以 学 到 以 下 知识 点 。 


e 创建 新 的 activity 及 配套 布局 。 

e. 从 一 个 activity 中 局 动 另 一 个 activity。 所 谓 局 动 activity， 束 是 请 求 
Android 系 统 创 建新 的 activity 实 例 并 调用 其 onCreate(Bundle?) x 
数 。 

e 在 父 activity (启动 方 ) 与 子 activity 〈 被 启动 方 ) 间 传 递 数据 。 


6.1 创建 第 二 个 activity 


要 创建 新 的 activity， 有 好 多 繁杂 工作 要 做 。 好 在 Android Studio 有 省 心 的 
新 建 activity 同 导 。 


感受 同 导 的 魔力 之 前 ， 先 打开 res/values/strings.xml 文 件 ， 添 加 本 章 要 用 
的 所 有 字符 串 资 源 ， 如 代码 清单 6-1 所 示 。 


代码 清单 6-1 添加 字符 串 资 源 (res/values/strings.xml) 


<resources> 


«string name="incorrect_toast">Incorrect!</string> 
<string name="warning text">Are you sure you want to do this?</string> 


«string name-"show answer button"»Show Answer</string> 
«string name-"cheat button"»Cheat!«/string» 
«string name-"judgment toast"»Cheating is wrong.«/string» 


</resources> 


6.1.1 创建 新 的 activity 


创建 新 的 activity 至 少 涉及 三 个 文件 : Kotlin 类 文件 、XML 布局 文件 和 应 
用 的 manifest 文 件 。 这 三 个 文件 关联 密切 ， 搞 错 了 残 有 大 矿 烦 。 因 此 ， 
强烈 建议 使 用 Android Studio 的 新 建 activity 回 导 功 能 。 


在 项 目 工 具 窗 口中 ， 和 右键 单 击 app/java 文 件 夹 ， 选 择 New > Activity ^ 
Empty Activity 荣 单项 启动 新 建 activity 问 导 ， 如 图 6-3 所 示 。 


onini , QO = $ - stings x 


let 
sap 


Edit translations for all locales in the translations editor, 


> re manifests 
了 paja. = —— 18 Java Class 


ACENEEEEREEEER .er 


hane"»GenQui ze/string 
tion australia Canberra is the capital of Australia,</string> 


»| ^i Android Resource File tion oceans" »The Pacific Ocean is larger than 
Link C++ Project with Gradle ides cean.</stringp 
‘' Z T Android Resource Directoy tion nideast'>The Suez Canal. connects the Red Sea 
P For oyt say .'" Sample Data Directory Ocean s/stringp 
Ar d rie tion africa The source of the Nile River is in Egypt.</string> 
> mora Copy NC ; tion anericas">The Anazon River is the lomest river 
Copy Paths dee % Scratch File 人 8N à Galery.. 
Copy Reference Lowe" Package ss 
Hy Paste sey " Android TV Activity 
| I" C++ Class Android Things Empty Activity (Requires minSdk » 24) 
Find Usages Ui. C/C++ Source i = Android Things Peripheral Activity (Requires minSdk >= 24) 
Analyze b i C/C++ Header File u Basic Activity 
E R i image Asset 8 Blank Wear Activity (Requires minSdk >= 23) 
“J Vector Asset ~ Bottom Navigation Activity 
Add to Favorites b ii Empty Activity 
.— Show Image Thumbnails QT c Kotiin Script ™ Fragment + ViewModel 
-d Singleton ™ Fullscreen Activity 
| Reformat Code VBL” 6 Grae Kotin DSL Buld Script |" Login Activity 
| Optimize Imports ^O © Gradle Kotin DSL Settings — 7" Master/Detail Flow 
| Reveal in Finder EB Fle Templates. " Navigation Drawer Activity 
E Open in Terminal ~~ Scrolling Activity 
vid È ADL > ^ Settings Activity 
4 @ Local History «Activity d Tabbed Activity 
18 P d Android Auto d 
E YN Bmabuanlna aalaatad dina m : 


Kl6-3 3 Gt activity [n] 55i". 


你 应 该 会 看 到 如 图 6-4 所 示 的 对 话 框 ， 在 Activity Name 处 输 
入 CheatActivity。 这 是 Activity 子 类 的 名 字 。 可 以 看 到 ，Layonut 
Name 自 动 赋 值 为 activity_cheat。 这 是 向 导 为 布局 文件 创建 的 基本 名 


称 。 


006 New Android Activity 


Configure Activity 


Android Studio 


Creates a new empty activity 


Activity Name: CheatActivity 


Generate Layout File 


Layout Name; activity_cheat 


(_} Launcher Activity 


Backwards Compatibility (AppCompat) 
Package name: com.bignerdranch.android.geoquiz |Y 


Source Language: Kotlin 


The name of the activity class to create 


Cancel | Previous | — Next 


图 6-4 ”新 的 空 activity 同 导 


包 名 决定 CheatActivity.kt 文 件 存放 的 位 置 ， 所 以 看 看 包 名 是 否 符 合 要 
最 后 ， 保 持 其 他 默认 设置 不 变 ， 点 击 Finish 按 钮 ， 让 癌 导 一 展 吴 


接 下 来 的 任务 是 设计 美观 的 UI。 本 章 开 头 的 截图 是 CheatActivity 视 图 
完成 后 的 样子 。 组 成 视图 的 部 件 定义 如 图 6-5 所 示 。 


LinearLayout 
Xnlns android http: //schenas android, con/apk/res/android" 
xnlns; tools="http://schemas, android, con/tools" 
androids layout, vidthe" match, parent" 
android: layout, heighte" natch, parent" 
android: gravityz "center" 
android:orientationz vertical" 


tools: contextz" con, bignerdranch, android. geoquiz. CheatActivity' 


TextView 
TextView 2M A Button 
| android: id="@+id/answer_text_view' te 
android: layout_width="wrap_content" android: id="@+id/show_answer_button" 
android: layout_width="wrap_content" ; l 
android: layout_height="wrap_content" i android: layout_width="wrap_content" 
; android: layout_height="wrap_content" 
android: padding=" 24dp" ets android: layout heightz"wrap content" 
: android: padding="24dp" 
android: text="@string/warning_text" android: text="@string/show_answer_button" 
tools: text="Answer" 


图 6-5 ”部 件 定 义 示意 
打开 res/layout/activity_cheat.xml 文 件 并 切换 至 文字 视图 模式 。 


参照 图 6-5 创 建 布局 XML 文件 ， 依 次 以 LinearLayout 部 件 蔡 换 样 例 布 
局 。 完 成 后 ， 记 得 对 照 代 码 清单 6-2 核 查 。 


代码 清单 6-2 第 二 个 activity 的 布局 部 件 定义 


(res/layout/activity_cheat.xml ) 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
android:gravity-"center" 
android:orientation-"vertical" 
tools:context-"com.bignerdranch.android.geoquiz.CheatActivity"» 


«TextView 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:padding-"24dp" 
android: text="@string/warning text"/> 


<TextView 
android: id="@+id/answer_text_view" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: padding="24dp" 
tools: text="Answer"/> 


<Button 
android: id="@+id/show_answer_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android: text="@string/show_answer_button"/> 


</LinearLayout> 


bene iua 时 使 用 的 布局 文件 ， 不 过 ， 借 助 开 发 工具 ， 可 以 
预览 默认 布局 在 设备 横 屏 时 的 显示 效果 。 


在 预览 工具 窗口 中 ， 找到 预览 界面 上 方 工 具 栏 里 一 个 画 着 旋转 设备 的 按 
H GEIER) 。 点 击 该 按钮 切换 布局 预览 方位 ， 如 图 6-6 所 示 。 


*- Oy D Pixely = 287 (€) AppTheme~ 
Q-. VY Portrait 


UI Mode » 
Night Mode » 


Create Landscape Variation 
Create Tablet Variation 
Create Other... 


图 6-6” 横 屏 预览 布局 Cactivity cheat.xml) 


可 以 看 到 ， 默 认 布 局 在 竖 屏 和 横 屏 时 效果 都 不 错 。 布 局 搞定 了 ， 接 痢 是 
创建 新 的 activity 子 类 。 


6.1.2 ”创建 新 的 activity 子 类 


CheatActivity.kt 文 件 已 自动 在 编辑 器 工具 窗口 打开 。 如 果 没 有 ， 在 项 目 
工具 窗口 中 找到 并 打开 它 。 


当前 ，CheatActivity 类 已 有 onCreate(Bundle? ) 的 默认 实现 ， 用 来 
将 activity_cheat.xml 文 件 中 的 布局 资源 ID 传递 给 
setContentView(...). 


CheatActivity 类 的 onCreate(Bundle?) 函 数 还 有 很 多 事情 要 做 。 现 
在 ， 先 一 起 来 看 看 新 建 activity 回 导 自 动 完成 的 另 一 件 事 : 在 应 用 
manifest 配 置 文件 中 声明 CheatActivity。 


6.1.3 ”在 manifest 配 置 文件 中 声明 activity 


manifest Ex F Sa 元 数据 的 XML 文 件 ， 用 来 同 Android 操 作 系 
统 描述 应 用 。 该 文件 总 是 以 AndroidManifest.xml 命 名 ， 可 在 项 目的 
app/manifests 目 录 中 找 到 pr 


在 项 目 工 具 窗 口中 ， 找 到 并 打开 manifests/AndroidManifest.xml。 还 可 使 
Fd Android Studio 的 快速 打开 文件 功能 : 使 用 Command+Shift+O (或 
Ctrl+ShifttN) 快捷 键 , “呼出 ”快速 打开 对 话 框 ， 利 用 提示 功能 或 直接 
输入 目标 文件 名 ， 按 回 车 键 打开 。 


应 用 的 所 有 activity 都 必须 在 manifest 配 置 文件 中 声明 ， 这 样 操作 系统 才 
能 够 找到 它们 。 


创建 MainActivity 时 ， 由 于 使 用 了 新 建 应 用 向 导 ， 因 此 向 导 已 自动 完 
成 声明 工作 。 同 样 ， 如 代码 清单 6-3 灰 底部 分 所 示 ， 新 建 activity 向 导 也 
自动 声明 了 CheatActivity。 


代码 清单 6-3 ”在 manifest 配 置 文件 中 声 
明 CheatActivity (manifests/AndroidManifest.xml ) 


«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.bignerdranch. android. geoquiz"> 


<application 
android: allowBackup="true" 
android: icon="@mipmap/ic_launcher" 
android: label="@string/app_name" 
android: roundIcon="@mipmap/ic_launcher_round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme" > 
«activity android:name=".CheatActivity"> 


</activity> 
«activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" / 
«/intent-filter» 
«/activity» 
</application> 


</manifest> 


这 里 的 android:name 属 性 是 必需 的 。 属 性 值 前 面 的 点 号 〈. ) 告诉 操作 
A: activity 类 文件 位 于 manifest 配 置 文件 头 部 包 属 性 值 指定 的 包 路 径 
Js 

android:name 属 性 值 也 可 以 设置 成 完整 的 包 路 径 ， 比 如 
android:name-z"com.bignerdranch.android.geoquiz.CheatActiv 


这 与 代码 清单 6-3 里 的 写法 效果 相同 。 
manifest 配 置 文件 里 还 有 很 多 有 趣 的 东西 。 不 过 ， 现 在 还 是 先 集中 精力 


搞定 CheatActivity 的 配置 和 运行 。 在 后 续 章 节 中 ， 我 们 还 将 学 习 到 更 
多 有 关 manifest 配 置 文件 的 知识 。 


6.1.4 ”为 MainActivity 添 加 CHEATI! 按 钮 


按照 开发 计划 ， 用 户 在 MainActivity 用 户 界面 上 点 击 某 个 按钮 ， 应 用 
会 立即 创建 CheatActivity 实 例 ， 并 显示 其 用 户 界 面 。 这 就 需要 在 
res/layoutactivity_main.xml 和 res/layout-land/activity_main.xml 布 局 文件 中 
定义 新 按钮 。 


从 图 6-2 可 知 ， 新 添加 的 CHEAT! 按 钮 应 该 放 在 NEXT 按 钮 的 上 方 。 在 默 
认 的 垂直 布局 中 ， 添 加 新 按钮 定义 并 设置 其 为 根 LinearLayout 的 直接 
子 类 。 新 按钮 应 该 定义 在 NEXT 按 钮 之 前 ， 如 代码 清单 6-4 所 示 。 


代码 清单 6-4 在 默认 布局 中 添加 CHEATI! 按 钮 


(res/layout/activity_main.xml ) 


</LinearLayout> 


<Button 
android: id="@+id/cheat_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android: layout_marginTop="24dp" 
android: text="@string/cheat_button" /> 


<Button 
android: id="@+id/next_button" 
"A 


</LinearLayout> 


在 水 平 布局 模式 中 ， 新 按钮 定义 在 根 FrameLayout 的 底部 居中 位 置 ， 如 
代码 清单 6-5 所 示 。 


代码 清单 6-5 ”在 水 平 布 局 中 添加 CHEATI! 按 钮 Ces/layout- 


land/activity main.xml) 


</LinearLayout> 


<Button 
android: id="@+id/cheat_button" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout gravity-"bottom|center horizontal" 
android: text="@string/cheat_button" /> 


<Button 
android: id="@+id/next_button" 
wets LD 


</FrameLayout> 


重新 打开 MainActivity.kt 文 件 ， 添 加 新 按钮 变量 以 及 资源 引用 代码 。 最 
后 为 CHEATI! 按 钮 添加 View.onClickListener 监 听 器 代码 存根 ， 如 代 
码 清单 6-6 所 示 。 


代码 清单 6-6 ”启用 CHEAT! 按 钮 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var trueButton: Button 
private lateinit var falseButton: Button 
private lateinit var nextButton: Button 
private lateinit var cheatButton: Button 
private lateinit var questionTextView: TextView 


override fun onCreate(savedInstanceState: Bundle?) { 


nextButton = findViewById(R.id.next_button) 
cheatButton = findViewById(R.id.cheat button) 
questionTextView = findViewById(R.id.question_text_view) 


nextButton.setOnClickListener ( 
quizViewModel.moveToNext() 
updateQuestion() 


} 


cheatButton.setOnClickListener { 
// Start CheatActivity 
} 


updateQuestion() 


准备 工作 做 完了 ， 下 面 来 学 习 如 何 启动 CheatActivity。 


6.2 ”启动 activity 


一 个 activity 启 动 男 一 个 activity 最 简单 的 方式 是 使 
FastartActivity(Intent) Axx. 


你 也 许 会 想当然 地 认为 ，startActivity(Intent) 函 数 是 一 个 静态 函 
数 ， 启 动 activity 就 是 调用 Activity 子 类 的 该 函数 。 实 际 并 非 如 此 。 
activity 调 用 startActivity(Intent) 函 数 时 ， 调 用 请 求实 际 发 给 了 操 
作 系 统 。 


准确 地 说 ， 调 用 请 求 发 送 给 了 操作 系统 的 
ActivityManager。ActivityManager 人 负责 创建 Activity 实 例 并 调用 
其 onCreate(Bundle?) 函 数 ， 如 图 6-7 所 示 。 


应 用 | Android 操 作 系统 
ActivityManager 


1 
m 


<---------------- 
4 


<-- 


startActivity(Intent) 


| 


图 6-7 启动 activity 


ActivityManager 该 启动 哪个 activity 呢 ? 那 就 要 看 Intent 参 数 里 的 信 
A 了 o 


基于 intent 的 通信 
intent 对 象 是 component 用 来 与 操作 系统 通信 的 一 种 媒介 工具 。 目 前 为 


止 ， 我 们 唯一 见 过 的 component 就 是 activity。 实 际 上 还 有 其 他 一 些 
component: service、 broadcast receiver 以 及 content provider。 


intent 是 一 种 多 用 途 通 信 工 具 。Intent 类 有 多 个 构造 函数 ， 能 满足 不 同 
的 使 用 需求 。 


在 GeoQuiz 应 用 中 ，intent 用 来 告诉 ActivityManager 该 启动 哪个 
activity， 因 此 可 使 用 以 下 构造 函数 : 


在 cheatButton 的 监听 器 代码 中 ， 创 建 包 含 CheatActivity 类 的 
Intent 实 例 ， 然 后 将 其 传 入 startActivity(Intent) 函 数 ， 如 代码 清 
单 6-7 所 示 。 

代码 清单 6-7 启动 CheatActivity (MainActivity.kt) 


cheatButton.setOnClickListener { 
// Start CheatActivity 


val intent = Intent(this, CheatActivity::class.java) 
startActivity (intent) 


传 入 Intent 构 造 函 数 的 CLlass 类 型 参数 告诉 ActivityManager 应 该 局 
动 哪个 activity。Context 人 参数 告诉 ActivityManager 在 哪里 可 以 找到 
Te 


在 启动 activity 前 ，ActivityManager 会 确认 指定 的 Class 是 否 已 在 
manifest 配 置 文 件 中 声明 。 如 果 已 完成 声明 ， 则 启动 activity， 应 用 正常 
运行 。 有 反之 ， 则 抛 出 ActivityNotFoundException 异 常 ， 应 用 朋 尝 。 
这 就 是 必须 在 manifest 配 置 文件 中 声明 应 用 的 全 部 activity 的 原因 。 


运行 GeoQuiz 应 用 。 点 击 CHEAT! 按 钮 ， 新 activity 实 例 的 用 户 界 面 将 显 
示 在 屏幕 上 。 点 击 后 退 按钮 ，CheatActivity 实 例会 被 销 

毁 ，MainActivity 实 例 的 用 户 界面 又 回来 了 。 

显 式 intent 与 隐 式 intent 


通过 指定 Context 与 Class 对 象 ， 然 后 调用 intent 的 构造 函数 来 创建 


Intent， 这 样 创 建 的 是 显 式 intent。 在 同一 应 用 中 ， 我 们 使 用 显 式 intent 
来 启动 activity。 


同一 应 用 里 的 两 个 activity 却 要 借助 于 应 用 外 部 的 ActivityManager 通 
言 ， 这 似乎 有 点 怪 。 不 过 ， 这 种 模式 会 让 不 同 应 用 间 的 activity 交 互 变 得 
容易 很 多 。 

一 个 应 用 的 activity 如 需 启动 男 一 个 应 用 的 activity， 可 通过 创建 隐 式 

intent 来 处 理 。 我 们 会 在 第 15 间 学 习 使 用 隐 式 intent。 


6.3 ”activity 则 的 数据 传递 


MainActivity 和 CheatActivity 都 已 就 绕 ， 现 在 可 以 考虑 它们 之 间 的 
数据 传递 了 。 图 6-8 展 示 了 两 个 activity 间 传递 的 数据 信息 。 


答案 是 否 正确 


MainActivity CheatActivity 


FP ae PEE 


图 6-8 MainActivity 与 CheatActivity 的 对 话 
CheatActivity 启 动 后 ，MainActivity 会 通知 它 当 前 问题 的 答案 。 

用 户 知道 答案 后 ， 点 击 回 退 键 回 到 MainActivity，CheatActivity 随 
即 被 销毁 。 在 销毁 前 的 瞬间 ， 它 会 将 用 户 是 否 作 浆 的 数据 传递 给 
MainActivity. 

接 下 来 ， 首 先 处 理 从 MainActivity 到 CheatActivity 的 数据 传递 。 


6.3.1 ”使 用 intent extra 


为 通知 CheatActivity 当 前 问题 的 答案 ， 需 将 以 下 语句 的 返回 值 传递 给 


Ki: 


questionBank[currentIndex].answer 


该 值 将 作为 extra 信 息 ， 附 加 在 传 入 startActivity(Intent) 函 数 的 
Intent 上 发 送出 去 。 


extra 信 息 可 以 是 任意 数据 ， 它 包含 在 Intent 中 ， 由 启动 方 activity 发 送 
出 去 。 可 以 把 extra 信 息 想 象 成 构造 函数 参数 ， 虽 然 我 们 无 法 使 用 带 目 定 
义 构造 函数 的 activity 子 类 。 (Android 创 建 activity 实 例 ， 并 负责 管理 其 
生命 周期 。) 接受 方 activity 接 收 到 操作 系统 转发 的 intent 后 ， 访 问 并 获 
取 其 中 的 extra 数 据 信息 ， 如 图 6-9 所 示 。 


GeoQuiz | Android 操 作 系 统 
MainActivity ActivityManager 


1 1 
— startActivity(Intent) 


component=CheatActivity 
extra=EXTRA_ANSWER_IS_TRUE 


oo 
| 

' i | 

图 6-9 intent extra: activity 间 的 通信 与 数据 传递 
如 同 MainActivity.onSaveInstanceSstate(Bundle) 函 数 中 用 来 保 

存 currentIndex 值 的 键 值 结构 ，extra 也 是 一 种 键 值 结 构 。 要 将 extra 数 


据 信息 添加 给 intent， 需 要 调用 Intent.putExtra(...) 函 数 。 确 切 地 
说 ， 是 调用 如 下 函数 : 


Intent.putExtra(...) 函 数 形式 多 变 。 不 变 的 是 ， 它 总 是 有 两 个 参 


数 。 一 个 参数 是 固定 为 String 类 型 的 键 ， 必 一 个 参数 是 键 值 ， 可 以 是 
各 种 数据 类 型 。 该 函数 返回 intent 自 喘 ， 因 此 ， 需 要 时 可 进行 链 式 调 
用 。 


V 


在 CheatActivity.kt 中 ， 为 extra 数 据 信 息 新 增 键 值 对 中 的 键 ， 如 代码 清单 
6-8 所 示 。 


代码 清单 6-8 ”添加 extra 常 量 (CheatActivity.kt) 


private const val EXTRA_ANSWER_IS TRUE = 
"com.bignerdranch. android. geoquiz.answer_is_ true" 


class CheatActivity : AppCompatActivity() { 


} 


activity 可 能 启动 目 不 同 的 地 方 ， 所 以 ， 应 该 在 获取 和 使 用 extra 信 息 的 
activity 那 里 ， 为 它 定 义 键 。 如 代码 清单 6-8 所 示 ， 记 得 使 用 包 名 修饰 
extra 数 据 信 息 ， 这 样 ， 可 避免 来 自 不 同 应 用 的 extra 间 发 生命 名 冲突 。 


现在 ， 可 以 返回 到 MainActivity， 将 extra 附 加 到 intent 上 。 不 过 我 们 有 
个 更 好 的 实现 方法 。 对 于 CheatActivity 处 理 extra 信 息 的 实现 细 

节 ，MainActivity 和 应 用 的 其 他 代码 无 须知 道 。 因 此 ， 我 们 可 转 而 
在 newIntent(. . . ) 函 数 中 封装 这 些 逻 辑 。 


在 CheatActivity 中 ， 创 建 newIntent(...) 函 数 ， 把 它 放 在 一 个 
companion 对 象 里 ， 如 代码 清单 6-9 所 示 。 


代码 清单 6-9 ”CheatActivity 中 的 newIntent(...) 函 数 
(CheatActivity.kt) 


class CheatActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


} 


companion object { 


fun newIntent(packageContext: Context, answerIsTrue: Boolean): Inte 
return Intent(packageContext, CheatActivity::class.java).apply 
putExtra(EXTRA ANSWER IS TRUE, answerIsTrue) 


使 用 新 建 的 newIntent(. . .) 函 数 可 以 正确 创建 Intent， 它 配置 
有 CheatActivity 需 要 的 extra。answerIsTrue 布 尔 值 以 


EXTRA_ANSWER_IS_TRUE 常 量 放 入 intent 以 供 解析 。 稍 后 ， 我 们 会 取出 
这 个 值 。 

即使 没有 类 实例 ， 使 用 companion 对 象 也 可 以 调用 类 函数 ， 这 点 和 Java 
里 的 静态 函数 类 似 。 像 这 样 在 companion 对 象 里 使 用 newIntent(. . . ) 函 
数 用 于 CheatActivity， 其 他 代码 就 很 容易 配置 它们 的 启动 intent。 


说 到 其 他 代码 ， 就 是 在 MainActivity 的 按钮 监听 器 中 使 
用 newIntent(. ..) 函 数 ， 如 代码 清单 6-10 所 示 。 


代码 清单 6-10 ”用 extra 启 动 CheatActivity (MainActivity.kt) 


cheatButton.setOnClickListener { 
// Start CheatActivity 


— val intent—= fntent(this EheatActivity::celass-java) 


val answerIsTrue = quizViewModel.currentQuestionAnswer 
val intent = CheatActivity.newIntent(this@MainActivity, answerIsTrue) 
startActivity (intent) 


这 里 只 需 一 个 extra， 但 如 果 有 需要 ， 也 可 以 附加 多 个 extra 到 同一 
个 Intent 上 。 如 果 附 加 多 个 extra， 也 要 给 newIntent(. . . ) 函 数 相 应 添 
加 多 个 参数 。 


要 从 extra 获 取 数 据 ， 会 用 到 如 下 函数 : 


Intent.getBooleanExtra(String, Boolean) 


第 一 个 参数 是 extra 的 名 字 。getBooleanExtra(...) 函 数 的 第 二 个 参数 
是 指定 默认 值 〈 默 认 答 案 ) ， 它 在 无 法 获得 有 效 键 值 时 使 用 。 


在 CheatActivity 代 码 中 ， 在 onCreate(Bundle?) 里 ， 从 目标 extra 里 
取 值 ， 存 入 成 员 变 量 中 ， 如 代码 清单 6-11 所 示 。 


代码 清单 6-11 ”获取 extra 信 息 (CheatActivity.kt) 


class CheatActivity : AppCompatActivity() { 


private var answerIsTrue = false 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity cheat) 


intent.getBooleanExtra(EXTRA ANSWER IS TRUE, false) 


answerIsTrue = 


WER, Activity.getIntent() ABE f 
HstartActivity(Intent) KAFR Intent &. 


最 后 ， 在 CheatActivity 代 码 中 ， 实 现 点 击 SHOW ANSWER 按 钮 后 获 
取 答 案 并 将 其 显示 在 TextView 上 ， 如 代码 清单 6-12 所 示 。 


代码 清单 6-12 ”提供 作弊 机 会 〈CheatActivity.kt) 


class CheatActivity : AppCompatActivity() { 


private lateinit var answerTextView: TextView 
private lateinit var showAnswerButton: Button 


private var answerIsTrue = false 


override fun onCreate(savedInstanceState: Bundle?) { 


intent.getBooleanExtra(EXTRA_ANSWER_IS TRUE, false) 


answerIsTrue = 


answerTextView = findViewById(R.id.answer text view) 
showAnswerButton - findViewById(R.id.show answer button) 
showAnswerButton.setOnClickListener { 


val answerText - when ( 
answerIsTrue -» R.string.true button 


else -» R.string.false button 


} 


answerTextView. setText (answerText ) 


以 上 代码 比较 直观 。TextView.setText(Int) 函 数 用 来 设置 TextView 
要 显示 的 文字 。TextView.setText(...) 函 数 有 多 种 变 体 。 这 里 通过 
传 入 资源 ID 调用 该 函数 。 


运行 GeoQuiz 应 用 。 点 击 CHEATI! 按 钮 弹出 CheatActivity 的 用 户 界 
面 ， 然 后 点 击 SHOW ANSWER 按 钮 偷 看 当前 问题 的 答案 。 


6.3.2 ”从 子 activity 获 取 返 回 结 


现在 ， 用 户 可 以 蜡 无 顾忌 地 偷 看 答案 了 。 如 果 CheatActivity 能 把 用 户 
是 否 看 过 答案 的 情况 通知 给 MainActivity 就 更 好 了 。 下 面 来 解决 这 个 
问题 。 


需要 从 子 activity 获 取 返 回信 息 时 ， 可 调用 如 下 函数 : 


Activity.startActivityForResult(Intent, Int) 


该 函数 的 第 一 个 参数 同 前 述 的 intent。 第 二 个 参数 是 请 求 代 码 。 请 求 代 
码 是 先 发 送 给 子 activity， 然 后 再 返回 给 父 activity 的 整数 值 ， 由 用 户 完 
义 。 在 一 个 activity 司 动 多 个 不 同类 型 的 子 activity 且 需要 判断 消息 回馈 六 
时 ， 就 会 用 到 该 请 求 代码 。 虽 然 MainActivity 只 启动 一 种 类 型 的 子 
activity， 但 为 应 对 未 来 的 需求 变化 ， 现 在 就 应 设置 请 求 代码 常量 。 


在 MainActivity 中 ， 修 改 cheatButton 的 监听 器 ， 调 
用 startActivityForResult(Intent，Int) 函 数 ， 如 代码 清单 6-13 所 
ZN o 


代码 清单 6-13 ”调用 startActivityForResult(...) 函 数 
(MainActivity.kt ) 


private const val TAG = "MainActivity" 
private const val KEY_INDEX = "index" 
private const val REQUEST_CODE_CHEAT = 6 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


cheatButton.setOnClickListener ( 


startActivityForResult(intent, REQUEST CODE CHEAT) 
} 


updateQuestion() 


01. 设置 返回 结 


实现 子 activity 发 送 返回 信息 给 父 activity， 有 以 下 两 种 函数 可 用 : 


setResult(resultCode: Int) 
setResult(resultCode: Int, data: Intent) 


一 般 来 说 ， 参 数 resultCode 可 以 是 以 下 任意 一 个 预定 义 常 量 。 


e Activity.RESULT OK 
e Activity.RESULT CANCELED 


《如 需 自己 定义 结果 代码 ， 还 可 使 用 另 一 个 常 
量 : RESULT FIRST USER. ) 


在 父 activity 需 要 依据 子 activity 的 完成 结果 采取 不 同 操作 时 ， 设 置 结 
果 代 码 就 非常 有 用 。 


例如 ， 假 设 子 activity 有 一 个 OK 按钮 和 一 个 Cancel 按 钮 ， 并 且 每 个 
按钮 的 点 击 动 作 分 别 设置 有 不 同 的 结果 人 代码。 那么， 根据 不 同 的 结 
果 代 人 码 ， 父 activity 束 能 采取 不 同 的 操作 。 


子 activity 可 以 不 调用 setResult(. . .) 函 数 。 如 果 不 需 要 区 分 附加 
在 intent 上 的 结果 或 其 他 信息 ， 可 让 操作 系统 发 送 默认 的 结果 代 
码 。 如 果子 activity 是 以 调用 startActivityForResult(...) 函 数 
启动 的 ， 结 果 代 码 则 总 是 会 返回 给 父 activity。 在 没有 调 

用 setResult(...) 函 数 的 情况 下 ， 如 果 用 户 按 了 后 退 按钮 ， 父 
activity 则 会 收 到 Activity.RESULT_CANCELED 的 结果 代码 。 


02. 返还 jntent 


在 GeoQuiz 应 用 中 ， 数 据 信息 需要 回 传 给 MainActivity。 因 此 ， 我 
们 需要 创建 一 个 Intent， 附 加 上 extra 信 息 后 ， 调 

用 Activity.setResult(Int，Intent) 函 数 将 信息 回 传 给 
MainActivity. 


如 代码 清单 6-14 所 示 ， 在 CheatActivity 代 码 中 ， 为 extra 的 键 增加 
和 常量， 再 创建 一 个 私有 函数 ， 用 来 创建 intent、 附 加 extra 并 设置 结 
果 值 。 然 后 在 SHOW ANSWER 按 钮 的 监听 器 代码 中 调用 它 。 


代码 清单 6-14 ”设置 结果 值 (CheatActivity.kt) 


const val EXTRA ANSWER SHOWN = "com.bignerdranch.android.geoquiz.answe 
private const val EXTRA ANSWER IS TRUE = 
"com.bignerdranch.android.geoquiz.answer is true" 


class CheatActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


showAnswerButton.setOnClickListener { 


answerTextView.setText(answerText) 
setAnswerShownResult(true) 


} 
private fun setAnswerShownResult(isAnswerShown: Boolean) { 
val data = Intent().apply { 
putExtra(EXTRA_ANSWER_SHOWN, isAnswerShown) 


setResult(Activity.RESULT OK, data) 


用 户 点 击 SHOW ANSWER 按 钮 时 ，CheatActivity 调 
用 setResult(Int，Intent) 函 数 将 结果 代码 以 及 intent 打 包 。 


然后 ， 在 用 户 按 回 退 键 回 到 MainActivity 时 ，ActivityManager 


调用 父 activity 的 以 下 函数 : 
onActivityResult(requestCode: Int, resultCode: Int, data: Intent) 


该 函数 的 参数 来 自 MainActivity 的 原始 请 求 代码 以 及 传 
入 setResult(Int，Intent) 函 数 的 结果 代码 和 intent。 


图 6-10 展 示 了 应 用 内 部 的 交互 时 厅 。 


GeoQuiz Android 操 作 系统 


| ActivityManager 
RP RCHEATHE, 
onClick View iA 


extrasEXTRA ANSWER |S TRUE 


— startActivityForResult(ntent Int) 


requestCode=0 
(Intent) 
CheatActivity 
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| 
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| 


用 户 点 击 后 退 按 钮 —_resultCode=RESULT_OK 


extra=EXTRA_ANSWER_SHOWN 


Wt 


(requestCode, resultCode, Intent) 


| 
onActivityResult{nt, Int, pip 
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| 
| 
| 
| 
| 
| 
| 
| 
V 


03. 


图 6-10 ”GeoQuiz 应 用 内 部 的 交互 时 序 图 


fg. fEMainActivity#% mionActivityResult(Int, Int, 
Intent) px Zi o Ab XR [n] zs 


处 理 返回 结 


在 QuizViewModelkt 里 ， 添 加 一 个 新 属性 来 保存 CheatActivity 传 
回 的 值 。 用 户 是 否 作 次 属于 UI 状态 数据 。UI 状 态 数 据 保存 

在 ViewMode1 里 不 会 像 activity 那 样 因 设备 配置 改变 被 销毁 而 丢失 数 
据 ， 这 在 第 4 章 已 探讨 过 。 所 以 ， 我 们 选择 使 用 QuizViewModel， 
而 不 是 MainActivity 来 保存 这 类 数据 ， 如 代码 清单 6-15 所 示 。 


代码 清单 6-15 在 QuizViewModel 里 记录 是 否 作 效 
(QuizViewModel.kt) 


class QuizViewModel : ViewModel() { 


var currentIndex = 0 
var isCheater = false 


接 下 来 ， 在 MainActivity.kt 中 新 增 一 个 成 员 变 量 来 保 

存 CheatActivity 回 传 的 值 ， 然 后 履 盖 onActivityResult(...) 
函数 获取 它 。 别 筷 了 检查 请 求 代码 和 返回 代码 是 否 符合 预期 。 实 上 践 
证 明 ， 这 样 做 会 方便 将 来 的 代码 维护 。onActivityResult(...) 
函数 的 实现 如 代码 清单 6-16 所 示 。 


代码 清单 6-16 onActivityResult(...) 函 数 的 实现 
(MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


override fun onActivityResult(requestCode: Int, 


resultCode: Int, 
data: Intent?) { 
super.onActivityResult(requestCode, resultCode, data) 


if (resultCode !- Activity.RESULT OK) ( 
return 


} 


if (requestCode == REQUEST CODE CHEAT) { 
quizViewModel.isCheater = 
data?.getBooleanExtra(EXTRA_ANSWER_SHOWN, false) ?: fa 


最 后 ， 修 改 MainActivity 中 的 checkAnswer(Boolean) 函 数 ， 确 


认 用 户 是 否 偷 看 答案 并 作出 相应 的 反应 。 基 于 isCheater 变 量 值 改 
变 toast 消 息 的 做 法 如 代码 清单 6-17 所 示 。 


代码 清单 6-17 “基于 isCheater 变 量 值 改 变 toast 消 息 
(MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private fun checkAnswer(userAnswer: Boolean) { 
val correctAnswer: Boolean = quizViewModel.currentQuestionAnsw 


val messageResId = when { 
quizViewModel.isCheater -> R.string.judgment_toast 
userAnswer == correctAnswer -> R.string.correct_toast 
else -> R.string.incorrect_toast 


} 
Toast.makeText(this, messageResId, Toast.LENGTH SHORT) 
.show() 


运行 GeoQuiz 应 用 。 点 击 CHEAT! 按 钮 ， 然 后 在 作 浆 界面 点 击 
SHOW ANSWER 按 钮 。 偷 看 答案 后 ， 点 击 回 退 键 。 在 回答 当前 问 
ANY, UR BIE RS I EUR. 


MEER, ARAL Pelee TATU? ROA BCAITE BE! 这 就 有 
点 严 奇 了 了。 如 果 想 得 到 更 合 情 理 的 评判 ， 请 动手 完成 6.6 节 的 挑战 
练习 ， 完 善 作弊 评判 逻辑 。 


目前 为 止 ， 就 功能 方面 来 讲 ，GeoQuiz 应 用 已 开发 完成 。 下 一 章 ， 
我 们 要 给 GeoQuiz 应 用 加 入 activity 过 场 动 画 ， 更 流畅 地 展 

示 CheatActivity， 让 应 用 表现 得 更 出 色 。 借 此 ， 我 们 将 学 习 在 给 
应 用 加 入 最 新 功能 的 同时 ， 如 何 让 其 兼容 老 版 本 Android 系 统 。 


6.4 _ activity 的 使 用 与 管理 


来 看 看 当 我 们 在 各 activity 间 往返 的 时 候 ， 操 作 系 统 层面 到 底 发 生 了 什 
么 。 首 先 ， 在 更 面 司 动 右 中 点 击 GeoQuiz 应 用 时 ， 操 作 系 统 并 没有 局 动 
应 用 ， 而 只 是 启动 了 应 用 中 的 一 个 activity。 确 切 地 说 ， 它 启动 了 应 用 的 
launcher activity。 在 GeoQuiz 应 用 中 ，MainActivity 就 是 它 的 launcher 
activity。 


使 用 应 用 向 导 创建 GeoQuiz 应 用 以 及 MainActivity 时 ，MainActivity 
默认 被 设置 为 launcher activity。 配 置 文件 中 ，MainActivity 声 明 的 
intent-filter 元 素 节 点 下 ， 可 看 到 MainActivity 被 指定 为 launcher 
activity， 如 代码 清单 6-18 所 示 。 


代码 清单 6-18 MainActivity 被 指定 为 ljauncher 


activity (manifests/AndroidManifest.xml ) 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
ido 


«application 
T 


«activity android:name=".CheatActivity"> 
«/activity» 


«activity android:name=".MainActivity"> 
<intent-filter> 


«action android: name="android.intent.action.MAIN"/> 


<category android:name="android.intent.category.LAUNCHER"/> 
</intent-filter> 


</activity> 
</application> 


</manifest> 


MainActivity 实 例 出 现在 屏幕 上 后 ， 用 户 可 点 击 CHEATI 按 
钮 。CheatActivity 实 例 随即 在 MainActivity 实 例 之 上 被 启动 。 此 
时 ， 它 们 都 处 于 activity 栈 中 ， 如 图 6-11 所 示 。 


9:00 


Geo! 9.00 GeoQuiz 


GeoQuiz 


Canberra is the capitel of Australia Canberra is the capital of Australia 


n Gd CHEATIRSR n Bd RE TRUE FALSE 


Are you sure you want to do this? 


SHOW ANSWER 


图 6-11 GeoQuiz 的 回 退 栈 


按 回 退 键 ，CheatActivity 实 例 被 弹出 栈 外 ，MainActivity 重 新 回 到 
栈 顶 部 ， 如 图 6-11 所 示 。 


在 CheatActivity 中 调用 Activity.finish() 函 数 同 样 可 以 
将 CheatActivity 从 栈 里 弹出 。 


如 果 运 行 GeoQuiz 应 用 ， 在 MainActivity 界 面 按 回 退 
键 ，MainActivity 将 从 栈 里 弹出 ， 我 们 将 退回 到 GeoQuiz 应 用 运行 前 的 
画面 ， 如 图 6-12 所 示 。 


900 


Wednesday fepi20 Weanesday feb) 20 


GeoQuiz 


| 
在 Android Stud io 中 Canberra is the capital of Australia. 
运行 GeoQuiz 


图 6-12 ”后 退 返 回 人 至 桌面 


如 果 从 桌面 启动 器 启动 GeoQuiz 应 用 ， 在 MainActivity 界 面 按 回 退 键 ， 
将 退回 到 曲面 启动 器 界面 ， 如 图 6-13 所 示 。 


$ A M e 0 GeoQuiz 
Photos Mans Gmail 


Chock GenQuiz 


Canberra is the capital of Australia 
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图 6-13 ”从 桌面 启动 器 启动 GeoQuiz 心 用 
cm 按 回 退 键 ， 将 返回 到 桌面 启动 器 启动 前 的 系统 界 


至 此 ， 可 以 看 到 ，ActivityManager 维 护 着 一 个 非特 定 应 用 独 享 的 后 

退 栈 。 所 有 应 用 的 activity 都 共享 该 后 退 栈 。 这 也 是 

将 ActivityManager 设 计 成 操作 系统 级 的 activity 管 理 器 来 负责 启动 应 

用 activity 的 原因 之 一 。 显 然 ， 后退 栈 是 作为 一 个 整体 共享 于 操作 系统 及 
设备 ， 而 不 单单 用 于 某 个 应 用 。 


(如 果 想 了 解 “ 向 上 ”按钮 ， 请 参阅 第 14 章 。) 


6.5 ”挑战 练习 : HEBES 


作 欧 不 会 局 。 当 然 ， 如 朱 他 们 能 一 直 避 开 反 作 浆 手段 ， 那 就 妃 当 别论 
了 。 正 所 谓 道 高 一 扩 ， 魔 局 一 丈 ， 也 许 他 们 能 做 到 。 


GeoQuiz YHA Pl. AVES a, Ay De eCheatActivity Kis 
除 作 次 痕迹 ， 然 后 回 到 MainActivity 界 面 ， 假 装 什 么 也 没 发 生 过 。 


使 用 第 4 章 学 到 的 知识 ， 在 设备 旋转 或 进程 销毁 时 ， 设 法 保 
存 CheatActivity 的 UI 状 态 数据 ， 堵 住 这 个 漏洞 。 


6.6 ”挑战 练习 : 按 题 记录 作 浆 状态 


当前 ， 哪 怕 用 户 只 在 一 道 题 上 作弊 ， 应 用 都 会 认为 他 们 题 题 作 整 。 完 善 
GeoQuiz 应 用 ， 按 题记 录用 户 作 整 情况 。 也 就 是 说 ， 如 果 用 户 偷 看 了 某 
道 题 的 答案 ， 那 就 在 他 回答 那 道 题 时 ， 弹 出 作 丈 警 告 消息 。 然 后 在 继续 
答题 过 程 中 ， 如 果 用 户 不 再 作 次 了， 就 给 出 答案 正确 与 否 的 评判 。 


= 7= Android SDK 所 本 与 兼容 


开发 完 GeoQuiz 应 用 ， 你 已 经 有 了 初步 的 开发 体验 。 本 章 ， 我 们 学 习 
Android 系 统 版 本 的 相关 知识 。 在 学 习 本 书后 续 章 市 ， 以 及 应 对 未 来 实 
PRIN SAR ALITA, (tas A, SRA AAAS A RUE. 


7.1 Android SDK 版 本 


表 7-1 显 示 了 各 SDK 版 本 、 它 们 相应 的 Android 固 件 版 本 ， 以 及 截至 2019 
年 5 月 使 用 各 版 本 的 设备 比例 。 


表 7-1 Android API 级 别 、 固 件 版 本 以 及 在 用 设备 比例 
设备 固件 版 本 


Jelly Bean 


Ice Cream Sandwich 4.0.3, 4.0.4 
Gingerbread 2.3.3 一 2.3.7 0.3 


* 注意 ， 本 表 已 忽略 比例 低 于 0.1% 的 在 用 设备 。 


每 一 个 有 发 布 代号 的 版 本 随后 都 会 有 相应 的 增 量 版 本 。 例 如 ，Ice Cream 


Sandwich 最 初 的 发 布 版 本 为 Android 4.0 (API 14 级 ) ， 但 没 过 多 久 ， 
Android 4.0.3 及 4.0.4 (API 152%) 的 增 量 发 行 版 本 就 取代 了 它 。 


当然 ， 表 7-1 中 的 比例 会 动态 变化 ， 但 这 些 数字 已 揭示 一 种 重要 趋势 ， 
即 新 版 本 发 布 后 ， 运 行 老 版 本 的 Android 设 备 不 会 立即 进行 升级 或 更 
换 。 和 截至 2019 年 5 月 ，119% 左 右 的 设备 仍然 运行 着 KitKat 或 更 早 版 本 的 系 
统 。 而 KitKat (Android 4.4) 早 在 2013 年 10 月 就 发 布 了 。 


(如 宁 感 兴趣 ， 可 去 Android 开 有 者 分 发 信息 中 心 网 站 得 看 表 7-1 数 据 的 
动态 更 新 。) 


为 什么 仍 有 这 么 多 设备 运行 着 老 版 本 Android 系 统 ? 主要 原因 在 于 
Android 设 备 生 产 商 和 运营 商 之 间 的 激烈 竞争 。 每 个 运营 商都 希望 拥有 
专属 定制 机 。 设 备 生 产 商 也 有 同样 的 压力 一 一 所 有 手机 都 基于 相同 的 操 
作 系统 ， 而 他 们 又 想 与 众 不 同 。 最 终 ， 届 服 于 市 场 和 运营 商 的 双重 压 
力 ， 各 种 专属 的 、 无 法 升级 的 定制 版 Android 设 备 消 癌 市 场 ， 令 人 眼花 
综 配 、 目 不 上 暇 接 。 


定制 版 Android 设 备 不 能 运行 Google 发 布 的 新 版 本 Android 系 统 。 因 此 ， 
用 户 只 能 寄 望 于 定制 版 的 兼容 升级 。 然 而 ， 即 便 可 以 升级 ， 通 常 也 是 
Google 新 版 本 发 布 后 数 月 的 事情 了 。 生 产 商 往往 更 愿意 投入 资源 推出 新 
设备 ， 而 不 是 持续 升级 旧 设 备 。 


7.2 ” Android 编程 与 兼容 性 问题 


各 种 设备 版 本 升级 清 后 以 及 Google 会 定期 发 布 新 版 本 ， 都 给 Android 编 
程 带 来 了 严重 的 兼容 性 问题 。 为 扩大 市 场 份额 ， 对 于 运行 之 前 3~4 个 较 
早 系统 版 本 ， 以 及 任何 最 新 版 本 的 Android 设 备 〈 还 要 考虑 各 种 尺 

寸 ) ，Android 开 发 人 员 必 须 保证 应 用 都 能 兼容 。 


还 好 ， 开 发 应 有 用时， 不同 尺寸 设备 的 处 理 要 比 想象 中 的 简单 。 手 机 屏幕 
尺寸 虽然 多 样 ， 但 Android 布 局 系统 为 编程 适 配 做 了 很 好 的 工作 。 要 基 
于 屏幕 尺寸 提供 定制 资源 和 布局 ， 可 使 用 配置 修饰 符 搞 定 〈 详 见 第 17 
38) 。 不 过 ， 对 于 同样 运行 着 Android 系 统 的 Android TV 和 Android Wear 
设备 ， 由 于 UI 差异 太 大 ， 应 用 的 交互 模式 和 设计 通常 需要 重新 考虑 。 


7.2.1 比较 合理 的 版 本 


本 书 文 持 的 最 老 版 本 是 API 212% (Lollipop) 。 虽 然 还 在 文 持 ， 但 我 们 
更 应 该 将 精力 投入 在 较 新 系统 版 本 上 (API21+ 级 ) 。 当 前 ， 
Gingerbread, Ice Cream Sandwich, Jelly Bean 和 KitKat 系 统 版 本 的 市 场 
份额 正 逐 月 下 降 ， 还 在 这 些 老 设备 上 投入 过 多 显然 得 不 偿 失 。 


对 于 增 量 版 本 ， 同 下 兼容 一 般 问 题 不 大 。 主 要 版 本 向 下 兼容 才 是 大 麻 
烦 。 也 就 是 说 ， 仅 支持 5.x 版 本 的 工作 量 不 大 ， 但 如 果 需 要 支持 到 4.x， 
考虑 到 这 么 多 不 同 版 本 的 差异 ， 工 作 量 就 相当 大 了 。 谢 天 谢 地 ，Google 
提供 了 一 些 兼 容 库 ， 大 大 降低 了 开发 难度 。 后 续 章 市 会 详细 介绍 它们 。 


新 建 GeoQuiz 项 目 时 ， 在 新 建 应 用 向 导 界 面 ， 我 们 设置 过 最 低 SDK 版 
本 ， 如 图 7-1 所 示 。 (注意 ，Android 的 “SDK 版 本 和 “API 级 别 * 两 者 叫 法 
可 以 交替 使 用 。) 


Configure your project 


Empty Activity 


Creates a new empty activity 


Create New Project 


Name 


GeoQuiz 


Package name 


com.bignerdranch.android.geoquiz 


Save location 


/Users/jeremy/AndroidStudioProjects/GeoQuiz 


Language 


Minimum API level 


API 21: Android 5.0 (Lollipop) 加 


© Your app will run on approximately 85.0% of devices. 
Help me choose 

"| This project will support instant apps 

Use AndroidX artifacts 


Cancel Previous Next 


图 7-1 设置 最 低 SDK 版 本 


除了 最 低 文 持 版 本 ， 还 可 以 设置 目标 版 本 和 编译 版 本 。 下 面 来 看 看 还 有 
哪些 默认 选项 ， 以 及 新 建 项 目 时 该 如 何 选择 。 


所 有 的 设置 都 保存 在 应 用 模块 的 build.gradle 文 件 中 。 编 译 版 本 独占 该 文 
件 。 虽 然 最 低 版 本 和 目标 版 本 也 设置 在 该 文件 中 ， 但 它们 的 作用 是 履 盖 
和 设置 AndroidManifest.xml 配 置 文件 。 


打开 应 用 模块 下 的 build.gradle 文 件 ， 碍 
看 compilesdkVersion、minsdkVersion 和 targetSdkVersion 的 属 
性 值 : 


compileSdkVersion 28 
defaultConfig { 


applicationId "com.bignerdranch.android.geoquiz" 
minSdkVersion 21 
targetSdkVersion 28 


7.2.2 SDK 最 低 版 本 

a a 操作 系统 会 拒绝 将 应 用 安装 在 低 于 此 标准 的 
Ww ^ 

例如 ， 设 置 版 本 为 API 212% (Lollipop) ， 便 赋予 了 系统 在 运行 Lollipop 
及 以 上 版 本 的 设备 上 安装 GeoQuiz 应 用 的 权限 。 而 在 运行 Lollipop 之 前 版 
本 的 设备 上 ，Android 系 统 会 拒绝 安装 GeoQuiz 应 用 。 


再 看 表 7-1， 你 就 会 明白 ， 为 什么 SDK 最 低 版 本 选 Lollipop 比 较 合适 ， 
为 有 90% 左 右 的 在 用 设备 支持 安装 你 的 应 用 。 


7.233 SDK 目标 版 本 


目标 版 本 的 设 定 值 会 告诉 Android 应 用 是 为 哪个 API 级 别 设计 的 。 大 多 数 
情况 下 ， 目 标 版 本 即 最 新 发 布 的 Android 版 本 。 


什么 时 候 需 要 降低 SDK 目 标 版 本 呢 ? 新 发 布 的 SDK 版 本 会 改变 应 用 在 设 
备 上 的 显示 方式 ， 甚 至 连 操作 系统 后 台 运 行 行为 都 会 受 影响 。 如 果 应 用 


已 开发 完成 ， 应 确认 它 在 新 版 本 上 能 否 按 预想 正常 运行 。 查 看 Android 
开发 者 Build.VERSION_CODES 网 站 上 的 文档 ， 检 查 可 能 出 现 问 题 的 地 
a I du vi NUUSDISH 
示 版 本 。 


不 提高 SDK 目 标 版 本 可 以 保证 的 是 ， 即 便 在 高 于 目标 版 本 的 设备 上 ， 应 
用 仍然 可 以 正常 运行 ， 且 运行 行为 仍 和 目标 版 本 保持 一 致 。 这 是 因为 新 
发 布 版 本 中 的 变化 已 被 忽略 。 


一 个 重要 提示 是 ， 想 要 在 Play Store 上 发 布 应 用 ， 目 标 版 本 最 低 设 置 为 多 
少 Google 是 有 严格 要 求 的 。 本 书 撰写 时 ， 新 应 用 和 新 应 用 升级 的 SDK 目 
标 版 本 最 低 要 求 是 API 21% (Lollipop) ， 和 否则 Play Store 会 拒绝 接受 。 

这 能 保证 用 户 受 益 于 最 新 Android 系 统 版 本 的 性 能 表现 和 安全 性 改进 。 

随 着 时 间 推 移 ， 以 及 新 Android 系 统 版 本 的 发 布 ，SDK 目 标 版 本 最 低 要 
求 也 在 提高 。 开 发 时 ， 记 得 关注 相关 文档 ， 了 解 该 何 时 更 新 你 应 用 的 

SDK 目 标 版 本 。 


7.2.4 ” SDK 编译 版 本 


最 后 要 说 的 SDK 编 译 版 本 设置 是 compileSsdkVersion。 该 设置 不 会 出 
现在 manifest 配 置 文件 里 。SDK 最 低 版 本 和 目标 版 本 会 通知 给 操作 系 
统 ， 而 SDK 编 译 版 本 只 是 你 和 编译 器 之 间 的 私有 信息 。 


Android 的 特色 功能 是 通过 SDK 中 的 类 和 函数 展现 的 。 在 编译 代码 时 ， 
SDK 编 译 厂 本 《编译 目标 ) 指定 具体 要 使 用 的 系统 版 本 。Android Studio 
Ee 0 0 
编译 目标 的 最 佳 选 择 为 最 新 的 API 级 别 。 当 然 ， 如 有 需要 ， 也 可 以 改变 
应 用 的 编译 目标 。 例 如 ，Android 新 版 本 发 布 时 ， 可 能 就 需要 更 新 编译 
目标 ， 以 便 使 用 新 版 本 引入 的 函数 和 类 。 


可 以 修改 build.gradle 文 件 中 的 SDK 最 低 版 本 、 目 标 版 本 以 及 编译 版 本 。 
不 过 要 注意 ， 修 改 完毕 ， 项 目 和 Gradle 更 改 重 新 同步 后 才能 生效 。 


7.2.5 ”安全 添加 新 版 本 API 中 的 代码 
GeoQnuiz 应 用 的 SDK 最 低 厂 本 和 编译 版 本 间 的 差异 较 大 ， 由 此 带 来 的 兼 


容 性 问题 需要 处 理 。 例 如 ， 在 GeoQuiz 应 用 中 ， 如 果 调 用 了 

Lollipop (API 212%) 以 后 的 SDK 版 本 中 的 代码 会 怎么 样 呢 ? 结果 显 
示 ， 在 Lollipop 设 备 上 安装 运行 时 ， 应 用 会 骨 尝 。 

这 个 问题 可 以 说 是 曾经 的 测试 点 梦 。 然 而 ， 受 益 于 Android Lint 的 不 断 
改进 ， 现 在 在 老 版 本 系统 上 调用 新 版 本 代码 时 ， 在 编译 时 就 能 发 现 潜在 
问题 。 也 就 是 说 ， 如 果 使 用 了 高 版 本 系统 API 中 的 代码 ，Android Lint 会 
提示 编译 错误 。 


目前 ，GeoQnuiz 应 用 中 的 简单 代码 都 来 自 API 21 级 或 更 早 版 本 。 现 在 ， 
我 们 来 增加 API 212% (Lollipop) 之 后 的 代码 ， 看 看 会 发 生 什么 。 


打开 MainActivity.kt 文 件 ， 在 CHEAT! 按 钮 的 0nClickListener 中 添加 
代码 清单 7-1 所 示 代 码 ， 在 显示 CheatActivity 时 ， 加 入 过 场 动画 。 


代码 清单 7-1 添加 动画 特效 代码 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


cheatButton.setOnClickListener { view -> 
// Start CheatActivity 
val answerIsTrue = quizViewModel.currentQuestionAnswer 
val intent = CheatActivity.newIntent(this@MainActivity, answerI 
val options = ActivityOptions 
.makeClipRevealAnimation(view, 0, 0, view.width, view.h 


startActivityForResult(intent, REQUEST CODE CHEAT, options.toBu 
j 


updateQuestion() 


以 上 代码 中 ， 我 们 使 用 ActivityOptions 类 来 定制 该 如 何 启 动 

activity。 调 用 makeClipRevealAnimation(...) 可 以 让 

CheatActivity 出 现时 带动 画 效果 。 传 

入 makeClipRevealAnimation(...) 中 的 参数 值 指定 了 视图 动画 对 象 
(这 里 是 指 CHEATI! 按 钮 ) 、 显 示 新 activity 位 置 的 x 和 y 坐标 (相对 于 动 


男 源 对 象 ) ， 以 及 新 activity 的 初始 高 宽 值 。 


请 注意 ， 这 里 直接 使 用 了 命名 lambda 值 参 view， 而 不 是 默认 的 让 名 
字 。 在 设置 点 击 监 听 才 的 上 下 文中 ，lambda 值 参 表 示 梓 点 击 的 视图 。 虽 
然 不 一 定 需要 明确 命名 ， 但 代码 可 读 性 提高 了 。 对 于 这 种 使 用 值 参 的 
阅读 代码 的 新 人 无 法 很 快 知道 值 参 的 含义 ， 因 此 推荐 做 好 命 


最 后 ， 调 用 options.toBundle() 把 Activityoptions 信 息 打 包 
到 Bundle 对 象 里 ， 然 后 传 给 startActivityForResult(...)。 随 
后 ，ActivityManager 就 知道 该 如 何 展 现 你 的 activity 了 。 


你 可 能 注意 到 了 ， 调 

用 ActivityOoptions.makeClipRevealAnimation(...) 的 地 方 
Android Lint 报 错 了 ， 在 函数 名 下 打出 了 波浪 线 ， 扣 击 该 函数 ， 还 会 弹 
出 一 个 红 灯 泡 图 标 。Android 直 到 SDK API 23 级 才 加 

入 makeClipRevealAnimation(...) 函 数 。 因 此 ， 这 段 代码 在 低 版 本 
CAPI 22 级 或 更 低 ) 设备 上 运行 时 会 让 应 用 骨 溃 。 


因为 SDK 编 译 版 本 为 API 28 级 ， 编 译 器 本 身 编译 代码 没有 问题 ， 而 
Android Lint 知 道 项 目 SDK 最 低 版 本 ， 所 以 及 时 指出 了 问题 。 


虽然 Lint 提 示 了 类 似 Call requires API level 23 (Current min is 21) 的 警告 信 
恩 ， 但 是 你 可 以 忽略 它 。 不 过 ， 出 了 问题 可 别 怪 Lint 没 有 提醒 你 。 


该 怎么 消除 这 些 错误 信息 昵 ? 一 种 办 法 是 提升 SDK 最 低 版 本 到 23。 然 
而 ， 提 升 SDK 最 低 版 本 只 是 回避 了 兼容 性 问题 。 如 果 应 用 不 能 安装 在 
API 23 级 和 更 老 版 本 设备 上 上， 那么 也 就 不 存在 新 老 系统 的 兼容 性 问题 
了 了。 因此， 实际 上 这 并 没有 真正 解雇 兼容 性 问题 。 


比较 好 的 做 法 是 将 高 API 级 别 代码 置 于 检查 Android 设 备 版 本 的 条 件 语句 
中 ， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 ”首先 检查 设备 的 编译 版 本 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


@SuppressLint("RestrictedApi") 
override fun onCreate(savedInstanceState: Bundle?) { 


cheatButton.setOnClickListener { view -> 


if (Build. VERSION.SDK_INT >= Build.VERSION CODES.M) { 
val options = ActivityOptions 
.makeClipRevealAnimation(view, 0, 0, view.width, vi 


startActivityForResult(intent, REQUEST CODE CHEAT, options. 
) else { 


startActivityForResult(intent, REQUEST CODE CHEAT) 
} 
} 


updateQuestion() 


Build.VERSION.SDK_INT 常 量 代表 了 Android 设 备 的 版 本 号 。 可 将 该 常 
量 同 代表 Marshmallow 版 本 的 常量 进行 比较 。 


现在 动画 特效 代码 只 有 在 API 23 级 或 更 高 版 本 的 设备 上 运行 应 用 才 会 被 
调用 。 应 用 代码 在 API 21 级 设备 上 终于 安全 了 ，Android Lint 应 该 也 满意 
了 吧 。 


在 Marshmallow 或 更 高 系统 版 本 的 设备 上 运行 GeoQuiz 应 用 。 演 试 偷 看 某 
题 的 答案 ， 确 认 看 到 了 新 动画 效果 。 


过 场 动画 一 内 而 过 ， 快 到 可 能 看 不 出 新 旧 变 化 。 为 了 看 出 差异 ， 可 以 调 
整 设备 来 减 慢 其 速度 。 打 开设 置 应 用 ， 导 航 至 开发 者 选项 〈System > 
Advanced > Developer options) 。 找 到 Transition animation scale 设 置 
项 ， 将 其 值 设 置 为 Animation Scale 10x， 如 图 7-2 所 示 。 


Developer options 


gua 


Q 


图 7-2 调 慢 过 场 动画 


设置 后 ， 动 画 效 果 的 速度 是 原来 的 十 分 之 一 ， 


Window animation scale 
Animation scale 1x 


Transition animation scale 
Animation scale 10x 


Animator duration scale 
Animation scale 1x 


Simulate secondary displays 
None 


Smallest width 
411 dp 


Simulate a display with a cutout 
None 


Hardware accelerated rendering 


Force GPU rendering 
Force use of GPU for 2d drawing 


< o 


这 下 应 该 


uy 
H5 1H 


楚 地 看 到 新 


动画 效果 了 。 章 新 运行 GeoQuiz 应 用 ， 但 看 慢 速 的 新 过 场 动 画 。 作 为 对 
比 ， 也 可 以 恢复 到 旧 代 码 ， 碍 看 之 前 的 activity 展 现 效果 。 继 续 学 习 之 
前 ， 记 得 把 刚才 的 过 场 动画 设置 恢复 为 默认 值 。 


还 可 以 在 Lollipop 设 备 ( 虚 拟 或 实体 ) 上 运行 GeoQuiz 应 用 。 当 然 ， 动 画 
特效 是 看 不 到 了 ， 但 可 验证 应 用 仍 能 正常 运行 。 


在 第 27 草 ， 你 还 会 看 到 通过 系统 版 本 检查 安全 使 用 新 API 的 例子 。 


7.2.6 JETPACK/# 


判断 API 级 别 执行 不 同 代码 逻辑 虽 然 有 用 ， 但 全 少 有 两 个 理由 告诉 我 们 
这 不 是 最 好 的 办 法 。 首 先 ， 这 意味 着 开发 者 适 配 不 同系 统 版 本 的 工作 量 
变 大 了 。 其 次 ， 不 同 设备 用 户 运 行 同一 应 用 的 体验 有 很 大 差异 。 


在 第 4 章 中 我 们 已 初步 了 解 了 Jetpack 库 和 Androidx。 除 了 提供 新 功能 

(比如 ViewModel) ，Jetpack 库 还 文 持 新 功能 回 后 兼容 ， 尽 量 让 新 老 设 
备 保持 一 致 的 用 户 体验 。 即 使 不 能 完全 解决 ， 至 少 能 做 到 让 开发 者 少 写 
一 些 API 级 别 的 条 件 判 断代 码 。 


许多 AndroidX 库 文件 融 是 之 前 文 持 库 的 一 些 修 改版 本 。 只 要 有 可 能 ， 建 
议 都 要 用 。 这 样 的 话 ， 就 不 用 检查 API 级 别 ， 判 断 不 同 设备 执行 不 同 代 
码 了 。 新 老 设 备用 户 的 应 用 体验 也 一 致 了 ， 开 发 因此 会 轻松 好 多 。 


不 幸 的 是 ，Jetpack 库 还 没有 彻底 解决 兼容 性 问题 。 或 者 说 ， 它 并 不 拥有 
所 有 你 想 要 的 新 功能 。 当 然 ，Android 团 队 目前 做 得 还 不 错 ， 一 直 全 力 

在 癌 Jetpack 库 中 添加 新 API， 但 是 你 仍然 会 发 现 某 些 API 不 可 用 。 如 果 

Tees 那 只 好 乖乖 写 点 儿 判 断代 码 ， 等 待 Jetpack 版 本 的 新 
APUJH d 


7.3 ”使 用 Android 开 发 者 文档 


从 Android Lint 错 误 信 息 中 可 看 到 不 兼容 代码 所 属 的 API 级 别 。 也 可 在 
Android 开 发 者 文档 里 查看 各 API 级 别 特有 的 类 和 函数 。 


越 早 熟悉 使 用 开发 者 文档 越 有 利于 开发 。 没 人 能 记 住 Android SDK 中 的 
海量 信息 ， 更 不 要 说 定期 发 布 的 新 版 本 系统 了 。 因 此 ， 学 会 查阅 SDK 文 
档 ， 不 断 学 习 新 的 知识 尤 显 重要 。 


Android 开 发 者 文档 是 优秀 而 丰富 的 信息 来 源 。 文 档 分 为 六 大 部 分 : F 

~ Android Studio. Google Play, Android Jetpack、 参 考 文档 和 新 闻 。 

如 果 有 机 会 ， 一 定 要 仔细 研读 这 些 资料 。 从 开发 起 步 到 在 Google Play fii 
店 里 发 布 应 用 ， 每 一 部 分 都 包含 了 Android 开 发 方方面面 的 内 容 。 


。 平台 : 基本 平台 信息 、 重 点 关注 平台 基础 文 持 和 Android 不 同 的 系 
统 版 本 。 

e Android Studio: 开发 工具 相关 的 文档 ， 介 绍 不 同 的 开发 工具 和 流程 
以 方便 开 肥 。 


帮助 部 署 应 用 以 及 使 你 的 应 用 更 受用 户 欢迎 的 一 些 指 
导 和 小 技巧 。 

Android Jetpack: 介绍 Jetpack 库 以 及 Android 团 队 是 如 何 致 力 提高 
发 体验 的 。 本 书 只 用 了 部 分 Jetpack 库 ， 建 议 你 查看 全 部 库 内 容 ， 熟 
GEM. 

参考 文档 : 开发 者 文档 主页 。 在 这 里 ， 可 以 找到 开发 框架 中 各 种 类 
的 使 用 信息 ， 以 及 各 种 开发 学 习 教 程 和 实验 代码 。 用 好 它们 ， 可 以 
帮 你 提高 开发 水 平 。 

新 闻 : 最 新 文章 和 新 闻 消 恕 ， 方 便 你 了 解 Android 开 发 的 最 新 动 


你 也 可 以 将 开发 者 文档 下 载 到 本 地 离线 使 用 。 在 Android Studio 的 SDK 
Manager (Tools SDK Manager) 中 ， 点 击 SDK Tools 选 项 页 iP 
Documentation for Android SDK， 然 后 点 击 Apply 按 钮 。 随 后 弹出 页 面 提 
示 下 载 内 容 大 小 ， 待 你 确认 后 即 开始 下 载 。 下 载 完成 后 ， 当 初 下 载 SDK 
工具 的 目录 《如 有 果 不 知 道 在 哪里 ， 可 以 在 SDK Manager 里 碍 看 ) 中 会 新 
增 一 个 docs 目 录 ， 里 面包 含 了 全 部 的 开发 者 文档 。 


在 文档 网 站 上 ， 为 确定 makeClipRevealAnimation(...) 类 所 属 的 API 
级 别 ， 使 用 文档 浏览 器 右上 和 角 的 搜索 框 搜索 它 。 选 择 
ActivityOptions 很 可 能 是 第 一 条 搜索 结果 ) ， 可 导航 至 该 类 的 参 
OC TUE 如 图 7-3 所 示 。 该 页 面 右边 的 链接 可 以 链接 到 不 同 的 部 
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Android Developers Docs > Reference 
ActivityOptions 


public class ActivityOptions 
extends Object 


java.lang.Object 
4 android. app.ActiityOptions 


Helper class for building an options Bundle that can be used with Context.startActivity(Intont, Bundle) and 
related methods. 


Summary 

String EXTRA, USAGE, TIME, REPORT 
A long in the extras delivered by requestUsageTimeRaport(Pendinglntent) that contains the 
{otal time (in m) the user spent in the app flow. 

String EXTRA. USAGE, TIHE REPORT PACKAGES 


A Bundle in the extras delivered by requestUsageTineReport(Pendinglntent) that contains 
detailed information about the time spent in each package associated with the app; each key is à 
package name, whose value i a long containing the time (in ms), 


Public methods 
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added in API level 16 
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Constants 
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Constants 


EXTRA USAGE. TIME REPO... 
EXTRA USAGE TIME REPO.. 
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qetLeunchBounds 
getLaunchDleplayld 
getLockTaskMode 
makeBasic 

makeCl pRevesl Animation. 
makeCustomAnimation 
mekeScaleUpAnimation 
makeSoeneTraneltionAnima.. 
makeSceneTraneitlonAnima.. 
makeTaskL eunchBehind 
makeThumbnailSoslel pAni.. 
TequestübageTimetuport 
setAppVerficationBundle 
setLaunchBounds 
setLaunchDioplayld 
setLockTastfinabled 
toBundle 

update 


图 7-3 ”ActivityOptions 参 考 文档 页 面 


I] PRS, Ri deg . ) 函数 ， 查 看 
具体 的 描述 。 从 该 函数 名 的 右边 可 以 看 到 ， 函数 最 早 被 引入 的 API 级 
别 是 API 23 级 。 


如 果 想 查看 ActivityOptions 的 哪些 方法 可 用 于 API 21 级 ， 可 按 API 级 
别 过 滤 引 用 。 在 页 面 左 边 按 包 索引 的 类 列表 上 方 ， 找 到 API 级 别 过 滤 
框 ， 目 前 它 显示 为 API level: 28。 展 开 下 拉 表 单 ， 选 择 数字 21。 可 以 看 
到 ， 所 有 API 21 级 以 后 引入 的 方法 都 会 被 过 滤 掉 ， 并 自动 变 为 灰色 。 


API 级 别 过 滤 非 常 有 用 ， 可 以 让 你 知道 应 用 要 用 到 的 类 在 哪个 API 级 别 
可 用 。 例 如 ， 在 参考 文档 页 搜索 Activity 类 ， 以 API 21 级 过 滤 。 结 
显示 ， 诸 如 onMu1ltiwindowModeChanged(...) 的 很 多 方法 是 在 API 21 
级 才 开 始 添加 的 。 而 在 Nougat SDK 

中 ，onMultiWindowModeChanged(...) 属 于 附加 方法 ， 用 于 及 时 通知 
activity 从 全 屏 问 多 窗口 模式 转换 或 相反 ) 。 


在 后 续 章 节 的 学 习 过 程 中 ， 要 经 常 查 阅 开 发 者 文档 。 完 成 章 末 的 挑 
战 练习 ， 以 及 探究 某 些 类 "aOR the MR, 都 需要 查阅 相关 的 文档 
资料 。Google 还 在 不 断 地 更 新 和 改进 Android 文 档 ， 新 知识 和 新 概念 也 
因此 不 断 涌现 ， 学 无 止境 。 


7.4 挑战 练习 : 报告 编译 版 本 


在 GeoQuiz 应 用 的 页 面 布局 上 添加 一 个 TextView 部 件 ， 向 用 户 报告 设备 
运行 系统 的 API 级 别 ， 如 图 7-4 所 示 。 


9:00 b dtu | 


GeoQuiz 


Are you sure you want to do this? 


SHOW ANSWER 


API Level 28 


图 7-4 完成 后 的 用 户 界 面 


应 用 运行 时 才能 知道 设备 的 编译 版 本 ， 上 所 以 不 能 直接 在 布局 上 设 

置 TextView 值 。 打 开 Android 文 档 中 的 TextView 参 考 文档 页 ， 碍 

找 TextView 的 文本 赋值 函数 。 寻 找 可 以 接受 字符 串 或 Charsequence 的 
单 参数 函数 。 


男 外 ， 可 使 用 TextView 参 考 文档 里 列 出 的 其 他 XML 属 性 来 调整 文本 的 
尺寸 或 样式 。 


7.55 ”挑战 练习 : DRESSER 


允许 用 户 最 多 作 次 三次。 记录 用 户 偷 看 答案 的 次 数 ， 在 CHEAT! 按 钮 下 
显示 剩余 次 数 。 超 出 后 ， 茶 用 偷 看 按钮 。 


第 8 半 UIfragment 与 fragment 管 
Hz 


本 章 ， 我 们 开始 开发 一 个 名 为 CriminalIntent 的 应 用 。 该 应 用 可 详细 记录 
各 种 办 公 室 陋 习 ， 如 随手 将 脏 盘 子 丢 在 休 忌 室 水 池 里 ， 或 者 目 己 打印 完 
文件 就 走 ， 全 然 不 顾 公共 打印 机 里 已 缺 纸 ， 等 等 。 


用 CriminalIntent 应 用 记录 陋习 时 可 以 添加 标题 、 日 斯 和 照片 ， 它 还 支持 
在 联系 人 中 查找 当事人 ， 以 及 通过 E-mail、Twitter、Facebook 或 其 他 应 
用 提出 抗议 。 看 见 了 项 习 ， 记 录 下 来 ， 和 舒缓 了 心情 ， 束 可 以 继续 专心 做 手 
头 上 的 工作 了 。 


CriminalIntent 应 用 比较 复杂 ， 需 要 11 章 的 篇 幅 来 完成 。 如 网 8-1 所 示 ， 
应 用 的 用 户 界 面 由 列表 以 及 记录 明细 组 成 。 主 屏幕 会 显示 已 记录 陋习 的 
列表 ， 用 户 可 新 增 记录 或 查看 和 编辑 现 有 记录 。 


12:05 a B 


Criminallntent + SHOW SUBTITLE 


Scooter stolen while going to the restroom = 
Mon Nov 05 00:00:00 EST 2018 TITLE 


Paper clip Ponzi scheme Qp ， [corse cup thief 


Thu Oct 11 00:00:00 EDT 2018 


Fragment fraud 


DETAILS 

Fri Dec 21 00:00:00 EST 2018 

: WED NOV 14 00:00:00 EST 2018 
Popcorn left unattended, microwave on 
fire 9o Solved 
Thu Jan 24 00:00:00 EST 2019 

CHOOSE SUSPECT 

Coffee cup thief Qo 
Wed Nov 14 00:00:00 EST 2018 SEND CRIME REPORT 


图 8-1 CriminalIntent, 一 个 列表 明细 类 应 用 


8.4 UI 设计 的 灵活 性 需求 


你 可 能 会 认为 ， 开 发 一 个 由 两 个 activity 组 成 的 列表 明细 类 应 用 就 够 了 ， 
一 个 负责 管理 记录 列表 界面 ， 男 一 个 负责 管理 记录 明细 界面 。 点 击 列表 
中 某 条 记录 会 局 动 其 明细 activity 实 例 ， 按 回 退 键 会 销毁 明细 activity 并 返 
回 到 记录 列表 activity 界 面 。 想 看 下 一 条 记录 ， 同 样 操 作 即 可 。 


理论 上 这 种 想法 行 得 通 ， 但 如 果 需 要 更 复杂 的 用 户 界 面 及 多 屏幕 跳 转 ， 
EZ TPE? 


e 假设 用 户 正在 平板 设备 上 运行 CriminalIntent 应 用 。 平 板 设备 以 及 大 
尺寸 手机 的 屏幕 较 大 ， 能 够 同时 显示 列表 和 记录 明细 (最 起 码 在 横 
屏 模式 下 是 这 样 ) ， 如 图 8-2 所 示 。 


手机 平板 设备 


列表 记录 明细 


记录 明细 


图 8-2 ”手机 和 平板 设备 上 理想 的 列表 明细 界面 


。 假设 用 户 正 在 手机 上 查看 记录 明细 信息 ， 并 想 查 看 列表 中 的 下 一 条 
记录 信息 。 如 果 无 须 返 回 列表 界面 ， 滑 动 屏 幕 就 能 碍 看 下 一 条 记录 
束 好 了 。 每 背 动 一 次 屏幕 ， 应 用 便 目 动 切 换 到 下 一 条 记录 明细 。 


可 以 看 出 ， 灵 活 多 变 的 UI 设计 是 以 上 假设 情景 的 共同 点 。 也 就 是 说 ， 为 
了 适应 用 户 或 设备 的 需求 ，activity 界 面 可 以 在 运行 时 组 装 ， 甚 全 重新 组 
装 。 


activity 自 身 并 不 具备 这 样 的 灵活 性 。activity 视 图 可 以 在 运行 时 切换 ， 但 
控制 视图 的 代码 必须 在 activity 中 实现 。 结 果 ， 各 个 activity 还 是 得 和 特定 
的 用 户 界面 紧 紧 绑 定 。 


8.2 5| Xfragment 


采用 fragment 而 不 是 activity 来 管理 应 用 UI 可 让 应 用 具有 前 述 的 灵活 性 。 


fragment 是 一 种 控制 占 对 象 ，activity 可 委派 它 执 行 任务 。 这 些 任务 通常 
就 是 管理 用 户 界 面 。 受 管 的 用 户 界面 可 以 是 一 整 屏 或 整 屏 的 一 部 分 。 


管理 用 户 界 面 的 fragment 又 称 为 UI fragment。 它 也 有 自己 的 视图 (由布 
局 文件 实例 化 而 来 ) 。fragment 视 图 包含 了 用 户 可 以 交互 的 可 视 化 UI 元 


A9 


activity 视 图 能 预 留 位 置 供 fragment 视 图 插入 。 本 章 只 需要 插入 一 个 
fragment。 如 果 有 多 个 fragment 要 插入 ，activity 视 图 就 提供 多 个 位 置 。 


根据 应 用 和 用 户 的 需求 ， 可 联合 使 用 fragment 及 activity 来 组 闭 或 重组 用 


户 界面 。 在 整个 生命 周期 中 ，activity 视 图 还 是 那个 视图 。 因 此 不 必 担 心 
会 违反 Android 系 统 的 activity 使 用 规则 。 


下 面 来 看 看 应 用 该 如 何 文 持 在 同一 屏 中 显示 列表 与 明细 内 容 。 我 们 应 用 
的 activity 视 图 会 由 一 个 列表 fragment 和 一 个 明细 fragment 组 成 。 明 细 视 
图 负责 显示 列表 项 的 明细 内 容 。 


选择 不 同 的 列表 项 就 显示 对 应 的 明细 视图 ，activity 负 责 以 一 个 明细 
fragment 蔡 换 另 一 个 明细 fragment， 如 图 8-3 所 示 。 这 样 ， 视 图 切换 的 过 
程 中 ， 也 不 用 销毁 activity 了 。 有 fragment 助 阵 ， 一 切 就 这 么 简单 。 


" HS 
Iik We 
fragment aome 一 fragment 
区 到 新 的 fragment 
AA RR 
activity E activity iR 


图 8-3 ”明细 fragment 的 切换 


除 列表 明细 类 应 用 外 ， 使 用 UI fragment 将 应 用 的 UI 分 解 成 构建 块 ， 同 样 
适用 于 其 他 类 型 的 应 用 。 例 如 ， 利 用 单个 构建 块 ， 可 以 方便 地 构建 分 页 
界面 、 动 画 侧 边栏 界面 等 更 多 定制 界面 。 男 外 ， 一 些 新 的 Android 


Jetpack API， 比 如 导航 控制 器 (navigation controller) ， 就 能 完美 地 支 
持 fragment。 所 以 ， 请 放心 整合 使 用 fragment 和 Jetpack API. 


8.3 ”着手 开发 CriminalIntent 


CriminalIntent 应 用 比较 复杂 ， 本 章 先 开发 应 用 的 记录 明细 部 分 。 完 成 
的 界面 如 图 8-4 所 示 。 


9:00 


Criminallntent 


TITLE 
Enter a title for the crime. 
DETAILS 


WED NOV 07 15:19:13 EST 2018 


C] Solved 


图 8-4 本 章 要 完成 的 CriminalIntent 应 用 界面 


图 8-4 所 示 的 用 户 界 面 是 由 一 个 叫 CrimeFragment 的 UI fragment 来 管理 
的 ， 而 CrimeFragment 实 例会 由 一 个 叫 MainActivity 的 activity 来 托 
管 。 


所 谓 托 管 ， 可 以 参照 图 8-5 这 样 理 解 : activity 在 其 视图 层级 里 提供 一 个 
位 置 ， 用 来 放置 fragment 视 图 。fragment 本 身 没有 在 屏幕 上 显示 视图 的 
能 力 。 因 此 ， 只 有 将 它 的 视图 放置 在 activity 的 视图 层级 结构 中 ， 
fragment 视 图 才能 显示 在 屏幕 上 。 


后 


MainActivity 


CrimeFragment 


onTextChanged() 


onCheckedChanged() 


图 8-5 MainActivityit'/É @CrimeFragment 


CriminalIntent 是 个 大 项 目 ， 借 助 对 象 图 解 可 以 更 好 地 理解 它 。 图 8-6 展 
示 了 CriminalIntent 项 目 涉及 的 对 象 以 及 对 象 间 的 关系 。 可 以 不 去 记忆 ， 
但 开工 前 ， 最 好 对 开发 对 象 有 一 个 整体 认识 。 


RE 


rire crime 


MainActivity 


dateButton titleField 


solvedCheckBox 


视图 (布局 ) textChangedListener 


checkedChangedListener 
EditText FrameLayout 
(crime title) (fragment container) 


图 8-6 ”CriminalIntent 必 用 的 对 象 图 解 〈 本 章 应 完成 部 分 ) 


可 以 看 到 ， 同 activity 在 GeoQuiz 应 用 中 扮演 的 角色 差 不 
多 ，CrimeFragment 也 负责 创建 并 管理 用 户 界 面 ， 以 及 与 模型 对 象 进行 
ANH. 


图 8-6 中 的 Crime、CrimeFragment 以 及 MainActivity 是 我 们 要 开发 的 
二 个 类 
= | AO 


CheckBox 
(crime solved) 


Button 
(crime date) 


crime 实例 代表 某 种 办 公 室 陋习 。 在 本 章 中 ， 一 个 crime 有 一 个 标题 、 一 


个 标识 ID、 一 个 日 期 和 一 个 表示 陋习 是 否 被 解决 的 布尔 值 。 标题 是 一 个 
描述 性 名 称 ， 比 如 < 向 水 模 中 倾倒 有 毒物 ”或 < 基 人 偷 了 我 的 酸奶 1 "等 
标识 ID 是 识别 Crime 实 例 的 唯一 元 素 。 


简单 起 见 ， 本 章 只 使 用 一 个 Crime 实 例 。 它 会 被 存放 在 CrimeFragment 
类 的 成 员 变 量 (crime) 中 。 


MainActivity 视 图 由 FrameLayout 部 件 组 成 ，FrameLayout 部 件 
为 CrimeFragment 视 图 安排 了 显示 位 置 。 


CrimeFragment 视 图 由 一 个 LinearLayout 部 件 及 其 三 个 子 视图 组 成 。 
这 三 三 个 子 视图 包括 一 个 EditText 部 件 、 一 个 Button 部 件 和 一 

个 CheckBox 部 件 。CrimeFragment 类 中 有 存储 它们 的 属性 ， 并 设 有 监 
听 器 ， 会 在 啊 应 用 户 操作 时 ， 更 新 模型 层 数据 。 


创建 新 项 目 
介绍 了 这 么 多 ， 是 时 候 创 建新 应 用 了 。 选 择 File = New = New Project... 


琳 单 项 创建 新 的 Android 应 用 。 如 图 8-7 所 示 ， 选 择 Empty Activity 模 板 


0:0 Create New Project 


Choose your project 


Phone and Tablet —WearOS TV Android Auto © Android Things 


Add No Activity 
Basic Activity Empty Activity 
Empty Activity 
Creates a new empty activity 


Cancel | | Previous Finish 


图 8-7 ”创建 CriminalImntent 心 用 
参照 图 8-8 配 置 项 目 ， 将 应 用 命名 为 CriminalIntent， 包 名 填 入 


com.bignerdranch.android.criminalintent， 开 发 语言 选 Kotlin，SDK 最 低 版 
本 指定 为 API 21: Android 5.0 (Lollipop)， 最 后 确认 色 选 了 Use AndroidX 


artifacts 。 


059 Create New Project 


Configure your project 


Name 


Criminalintent 


Package name 
¢ 
le | com.bignerdranch.android.criminalintent 


CrimeActivity 


Save location 


~/AndroidStudioProjects/Criminalintent2 
activity, crime 


Language 
Kotlin Y | 


x Minimum API level 
Empty Activity 


W 21: Android 5.0 (Lollipop) »J 
© Your app will run on approximately 85.0% of devices. 
Help me choose 


Creates a new empty activity (| This project wil support instant apps 
E Use AndroidX artifacts 


Cancel | Previous Next 


图 8-8 ”创建 CrimeActivity 项 目 

点 击 Finish 按 钮 生成 项 目 。 

下 一 步 ， 在 完善 MainActivity 之 前 ， 我 们 先 来 为 CriminalIntent 应 用 创 
建 模型 层 的 Crime 类 。 


8.4 ”创建 Crime 数 据 类 


在 项 目 工 具 窗 口中 ， 右 键 单 击 com.bignerdranch.android.criminalintent 
包 ， 选 择 New -> Kotlin File/Class 菜 单项 ， 创 建 一 个 名 为 Crime.kt 的 文 
件 。 


在 随后 打开 的 Crime.kt 中 ， 添 加 字段 代表 crime 的 ID、crime 标 题 、 发 生日 
期 和 处 理 状态 ， 使 用 一 个 构造 函数 给 ID 和 上 日 期 赋 初 值 。 类 定义 前 再 添加 
一 个 data 关 键 字 ， 让 Crime 类 成 为 一 个 数据 类 ， 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 创建 Crime 数 据 类 (Crime.kt) 


data class Crime(val id: UUID = UUID.randomUUID(), 
var title: String - "" 


3 
var date: Date = Date(), 
var isSolved: Boolean = false) 


导入 类 包 时 ， 在 确认 应 导入 哪个 版 本 的 Date 类 时 ， 选 择 


java.util.Date 类 。 


UUID 是 Android 框 架 里 的 工具 类 。 有 了 它 ， 生 成 唯一 D 值 就 方便 多 了 。 
在 构造 函数 里 ， 调 用 UUID.randomUUID( ) 生 成 一 个 随机 唯一 ID 值 。 


使 用 默认 的 Date 构 造 函 数 初始 化 Date 变 量 。 设 置 Date 变 量 值 为 当前 日 
期 ， 作 为 crime 的 默认 发 生 时 间 。 


以 上 是 本 章 CriminalIntent 模 型 层 及 Crime 类 所 需 的 全 部 代码 实现 工作 。 


至 此 ， 除 了 模型 层 ， 我 们 还 创建 了 能 够 托管 fragment 的 activity。 接 下 
来 ， 继 续 学 习 activity 托 管 fragment 的 具体 实现 。 


8.5 创建 UI fragment 

创建 UI fragment 与 创建 activity 的 步骤 相同 : 
。 定义 UI 布局 文件 ; 
。 创建 fragment 类 并 设置 其 视图 为 第 一 步 定 义 的 布局 ; 
。 编写 代码 以 实例 化 部 件 。 


8.5.1 定义 CrimeFragment 的 布局 


CrimeFragment 视 图 用 来 显示 包含 在 Crime 类 实例 中 的 信息 。 


首先 ， 打 开 res/values/strings.xml， 参 照 代 码 清单 8-2， 添 加 需要 的 字符 串 


代码 清单 8-2 ”添加 字符 串 资 源 (res/values/strings.xml) 


<resources> 
«string name-"app name"»Criminallntent«/string» 
«string name-"crime title hint"»Enter a title for the crime.</string> 


«string name-"crime title label"»Title«/string» 

«string name-"crime details label"»Details«/string» 

«string name-"crime solved label"»Solved«/string» 
</resources> 


然后 ， 定 义 UI。CrimeFragment 的 视图 布局 包含 一 个 垂直 
LinearLayout 部 件 ， 这 个 部 件 又 含有 五 个 子 部 件 : 两 个 TextView、 一 
个 EditText、 一 个 Button 和 一 个 CheckBox。 


要 创建 布局 文件 ， 在 项 目 工 具 窗口 中 ， 右 键 单 击 reslayout 文 件 光 ， 选 择 
New — Layout resource file 荣 单项 。 命 名 布局 文件 为 
fragment_crime.xml， 输 入 LinearLayout 作 为 根 元 素 节 点 。 


Android Studio 会 创建 文件 ， 并 自动 添加 LinearLayout。 在 
res/layout/fragment_crime.xml 文 件 中 ， 添 加 组 成 fragment 布 局 的 其 他 部 
件 ， 结 果 如 代码 清单 8-3 所 示 。 


代码 清单 8-3 fragment 视图 的 布局 文件 


(res/layout/fragment_crime.xml ) 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: orientation="vertical" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
android:layout margin-"16dp"» 


«TextView 
style-"?android:listSeparatorTextViewStyle" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: text="@string/crime_title_label"/> 


<EditText 
android: id="@+id/crime_title" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android:hint-"Qstring/crime title hint"/» 


«TextView 
style-"?android:listSeparatorTextViewStyle" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: text="@string/crime_details_label"/> 


<Button 
android: id="@+id/crime_date" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
tools:text-"Wed Nov 14 11:56 EST 2018"/» 


«CheckBox 
android:id-"(id/crime solved" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: text="@string/crime_solved_label"/> 


</LinearLayout> 


(第 一 个 TextView 定 义 里 出 现 了 新 语法 : style="? 
android: Je M c 不 要 担心 ， 学 完 10.4 市 ， 
你 就 会 明白 了 。 


之 前 说 过 ， 有 了 tools 命 名 空间 ， 你 束 可 以 提供 一 些 文字 信息 ， 供 预 宽 
ME XE, Rda RENT S. 这 样 ， 在 预览 界面 ， 


日 期 按钮 就 有 了 示例 文字 。 切 换 人 至 Design 视 图 ， 预 览 已 完成 的 
CrimeFragment 布 局 ， 如 图 8-9 所 示 。 


$« Qe [pher 28» @Appthemer © Default (en-us) © Os ® A 
eei 


TITLE 
Enter a title for the crime. 
DETAILS 
WED NOV 14 11:56 EST 2018 


(solved 


图 8-9 预览 CrimeFragment 布 局 


8.5.2 ”创建 CrimeFragment 类 


为 CrimeFragment 类 创建 男 一 个 Kotlin 文 件 。 这 次 ， 文 件 类 型 选择 
Class, Android Studio 会 自动 创建 空 的 类 定义 。 修 改 代码 ， 让 
CrimeFragment 类 继承 Fragment 类 ， 如 代码 清单 8-4 所 示 。 


代码 清单 8-4 继承 Fragment 类 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


} 


如 图 8-10 所 示 ， 修 改 代码 继承 Fragment 类 时 ，Android Studio 会 找到 两 
个 同名 Fragment 类 : android.app.Fragment 和 
androidx.fragment.app.Fragment。 前 者 是 Android 操 作 系 统 内 置 版 
Fragment， 而 我 们 要 用 的 是 Jetpack 库 版 Fragment， 所 以 选择 后 者 。 CE 
知道 ，Jetpack 库 是 在 androidx 打 头 的 包 里 的 。) 


class CrimeFragment : Fragment() { 
} Imports 


androidx.fragment.app.Fragment > 


© android.app.Fragment 


图 8-10 ”选择 Jetpack 库 中 的 Fragment 类 


如 果 看 不 到 Android Studio 的 提示 框 ， 或 者 误导 入 了 
android.app.Fragment 类 ， 请 先 删除 导入 语句 ， 然 后 使 用 
Option+Return 〈 或 Altr+Enter) 快捷 键 手动 重新 导入 。 千 万 不 要 摘 错 ， 我 


们 需要 的 是 androidx.fragment.app.Fragment。 
01. 两 类 fragment 


新 开发 的 Android 应 用 都 应 该 用 Jetpack Candroidx) 版 本 的 
fragment。 如 果 还 在 维护 旧 应 用 ， 你 可 能 会 看 到 男 外 两 个 版 本 的 
fragment: 系统 框架 版 本 和 v4 支持 库 版 本 。 看 到 这 些 Fragment 类 的 
遗留 版 本 ， 你 都 应 该 考虑 尽快 迁移 到 最 新 的 Jetpack 版 本 。 


fragment 是 在 API 11 级 系统 版 本 中 引入 的 ， 当 时 Google 发 布 了 第 一 


02. 


台 平 板 设备 。 可 以 说 ，UI 设计 要 灵活 ， 首 先是 针对 平板 这 样 的 大 

屏幕 设备 。 目 然 ， 运 行 API 11 或 更 高 版 本 系统 的 设备 用 的 就 是 系统 
内 置 的 框架 版 fragment。 随 后 ， 为 了 文 持 老 设 备 ， 一 个 兼容 版 的 

Fragment 实 现 被 添加 到 v4 文 持 库 版 本 中 。 目 然 ， 后 面 推出 的 新 版 本 

a 统 中 ， 这 两 个 版 本 的 fragment 一 直 都 有 新 特性 和 安全 补丁 
和 升级 。 


然而 ， 随 着 Android 9.0 (API 28) 的 发 布 ，Google 不 再 升级 系统 杠 
染 版 的 fragment 了 ， 它 被 废弃 了 。 男 外 ， 早 期 支持 库 版 本 的 
fragment 也 全 部 被 迁移 到 了 Jetpack 库 中 。 未 来 的 版 本 升级 只 针对 
Jetpack 版 本 的 fragment 进 行 了 。 


因此 ， 新 项 目 都 应 该 只 用 Jetpack 库 版 本 的 fragment， 现 有 的 项 目 也 
应 尽早 迁移 。 这 样 ， 才 能 保证 用 上 fragment 的 新 特性 ， 相 关 bug 也 能 
得 到 及 时 修复 。 


实现 fragment 和 后 命 周期 函数 


CrimeFragment 类 是 与 模型 及 视图 对 象 交 互 的 控制 器 ， 用 于 显示 特 
定 crime 的 明细 信息 ， 并 在 用 户 修改 这 些 信息 后 立即 进行 更 新 。 


在 GeoQuiz 应 用 中 ，activity 通 过 其 生命 周期 函数 完成 了 大 部 分 逻辑 
控制 工作 。 而 在 CriminalIntent 应 用 中 ， 这 些 工 作 是 由 fragment 的 生 

命 周 期 函数 完成 的 。fragment 的 许多 生命 周期 函数 对 应 着 我 们 熟知 
的 Activity 函 数 ， tk iHonCreate (Bundle?) Kžt (fragment £ fr 
周期 函数 详 见 8.6.2 节 ) 。 


在 CrimeFragment.kt 中 ， 新 增 一 个 Crime 实 例 属 性 以 及 一 
“Fragment .onCreate(Bundle?) 实 现 函 数 。 


编写 覆盖 函数 时 ，Android Studio 能 够 提供 便利 。 在 输 
AonCreate(Bundle?)P Z4, Android Studio 会 弹出 建议 函数 
清单 ， 如 图 8-11 所 示 。 


class CrimeFragment : Fragment() { 


private Lateinit var crime: Crime 


encre 

m ^ override fun onCreate(savedInstanceState: Bundle?) {...} c  Fragme.. 
m [override fun onCreateAnimation(transit: Int, enter: Boolean, ne... 
m$[override fun onCreateAnimator(transit: Int, enter: Boolean, nex... 

m $i override fun onCreateContextMenu(menu: ContextMenu?, v: View?, .. 

m 9| override fun onCreateOptionsMenu(menu: Menu?, inflater: MenuInf.. 

m 9| override fun onCreateView(inflater: LayoutInflater, container: .. 

m 9| override fun onActivityCreated(savedInstanceState: Bundle?) (.... 
m®loverride fun onViewCreated(view: View, savedInstanceState: Bund... 
Press ^. to choose the selected (or first) suggestion and insert a dot afterwards >> T 


图 8-11 7 tionCreate(Bundle?) 2X 


Ta [a] "ES ve PEonCreate(Bundle?) MAW, Android Studio 会 自动 创 
建 函 数 存 根 ， 包 括 调 用 超 类 实现 。 更 新 代码 创建 一 个 新 crime， 结 
果 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 ”和 履 盖 Fragment.onCreate(Bundle?) 
(CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
crime - Crime() 


以 上 实现 代码 有 以 下 几 扣 值得 一 说 。 


fe, Fragment.onCreate(Bundle?)@ AMA, 

而 Activity.onCreate(Bundle?) 是 受 保护 函数 。( 如 果 没 有 可 
见 性 修饰 符 ， 那 么 Kotlin 函 数 默认 是 公共 

的 。) Fragment. di [他 Fragment 生 命 
周期 函数 必须 是 公共 函数 ， 因 为 托管 fragment 的 activity 要 调用 它 
iT 


其 次 


欠 ， 类 似 于 activity，fragment 同 样 具有 保存 及 获取 状态 的 


bundle。 如 同 使 用 Activity . onSaveInstanceState (Bundle) % 
BUR, VRE RJ RHE m TR ns 
Fragment.onSaveInstanceState (Bundle) ri . 


最 后 ，fragment 的 视图 并 没有 在 Fragment.onCreate(Bundle? ) cf 
数 中 生成 。 虽然 我 们 在 该 函数 中 配置 了 fragment 实 例 | 但 创建 和 配 
置 fragment 视 图 是 另 一 个 Fragment 生 命 周期 函数 完成 

的 : onCreateView(LayoutInflater, ViewGroup?, 
Bundle? ). 


该 函数 会 实例 化 fragment 视 图 的 布局 ， 然 后 将 实例 化 的 View 返 回 给 
托管 activity。LayoutInflater 及 ViewGroup 是 实例 化 布局 的 必要 
Bundle 用 来 存储 恢复 数据 ， 可 供 该 函数 从 保存 状态 下 重建 
视图 。 


在 CrimeFragment.kt 中 ， 添 加 onCreateVvView(...) 函 数 的 实现 代 
码 ， 从 fragment_crime.xml 布 局 中 实例 化 并 返回 视图 ， 如 代码 清单 8- 
6 所 示 。 《可 使 用 图 8-11 所 示 的 方法 完成 函数 定义 。) 


代码 清单 8-6 We tionCreateView(...) MA 
( CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate(savedInstanceState) 
crime - Crime() 


} 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view = inflater.inflate(R.layout.fragment crime, container 
return view 


03. 


在 onCreateView(...) 函 数 中 ，fragment 的 视图 是 直接 通过 调 

用 LayoutInflater.inflate(...) 函 数 并 传 入 布局 的 资源 ID 生成 
的 。 第 二 个 参数 是 视图 的 父 视图 ， 我 们 通常 需要 父 视图 来 正确 配置 
部 件 。 第 三 个 参数 告诉 布局 生成 嚣 是否 立即 将 生成 的 视图 添加 给 父 
视图 。 这 里 传 入 了 false 参 数 ， 因 为 fragment 的 视图 将 由 activity 的 
容 右 视图 托管 。 稍 后 ，activity 会 处 理 。 


在 fragment 中 实例 化 部 件 


现在 来 生成 fragment 中 的 EditText、CheckBox 和 Button 部 件 。 它 
们 也 是 在 onCreateView(... ) 函 数 里 实例 化 。 


首先 处 理 EditText 部 件 。 视 图 生成 后 ， 使 用 findViewById 引 用 
它 ， 如 代码 清单 8-7 所 示 。 


代码 清单 8-7 生成 并 使 用 EditText 部 件 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 
private lateinit var titleField: EditText 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 


): View? { 
val view = inflater.inflate(R.layout.fragment crime, container 


titleField - view.findViewById(R.id.crime title) as EditText 


return view 


Fragment.onCreateView(...) 函 数 中 的 部 件 引用 几乎 等 同 于 

Activity.onCreate(Bundley?) 函 数 的 处 理 。 唯 一 的 区 别 是 ， 你 
调用 了 fragment 视 图 的 View.findViewById(Int) 函 数 。 以 前 使 用 
的 Activity.findviewById(Int) 函 数 十 分 便利 ， 能 够 在 后 台 自 
动 调用 View.findViewById(Int) 函 数 ， 而 Fragment 类 没有 这 样 


的 便利 函数 ， 因 此 必须 手动 调用 。 


接 下 来 ， 在 onstart() 生 命 周期 回调 里 给 EditText 部 件 添加 监听 
器 ， 如 代码 清单 8-8 所 示 。 


代码 清单 8-8 


给 EditText 部 件 添 加 监听 器 


( CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 


): View? { 


} 


override fun onStart() { 
super.onStart() 


val titleWatcher = object : TextWatcher { 


override fun beforeTextChanged( 


) 1 
} 


sequence: CharSequence?, 


start: Int, 
count: Int, 
after: Int 


// This space intentionally left blank 


override fun onTextChanged( 


) 1 
} 


sequence: CharSequence?, 
start: Int, 

before: Int, 

count: Int 


crime.title = sequence.toString() 


override fun afterTextChanged(sequence: Editable?) { 


} 


// This one too 


titleField.addTextChangedListener(titleWatcher) 
} 


} 


fragment 中 监听 器 函数 的 设置 和 activity 中 完全 一 样 。 这 里 是 创建 实 
现 TextWatcher 监 听 器 接口 的 匿名 内 部 类 。TextWatcher 有 三 个 函 
数 ， 不 过 现在 只 需 关注 其 中 的 onTextChanged(... ) 函 数 。 


在 onTextChanged(...) 函 数 中 ， 调 用 CharSsequence〔 代 表 用 户 
输入 ) 的 tostring() 函 数 。 该 函数 最 后 返回 用 来 设置 Crime 标 题 
的 字符 串 。 


注意 ，TextWatcher 监 昕 器 是 设置 在 onStart() 里 的 。 有 些 监听 器 
不 仅 能 在 用 户 与 之 交互 时 触发 ， 也 能 在 因 设备 旋转 ， 视 网 恢复 后 导 
致 数据 重 置 时 触发 。 能 啊 应 数据 输入 的 监听 器 有 EditText 的 
TextWatcher 以 及 CheckBox 的 0nCheckChangedListener。 


而 OnClickListener 只 能 啊 应 用 户 交 互 。 之 前 在 开发 GeoQuiz 时 ， 
我 们 只 会 用 到 点 击 事件 监听 器 ， 不 会 遇 到 设备 旋转 后 再 触发 监听 事 
件 的 场景 。 因 此 ， 所 有 的 监听 器 触发 事件 工作 都 是 

在 onCreate(. . .) 里 完成 的 。 


视图 状态 在 onCreateView(...) 之 后 和 onStart() 之 前 恢复 。 视 
图 状态 一 恢复 ，EditText 的 内 容 就 要 用 crime.tit1le 的 当前 值 重 
置 。 这 时 候 ， 如 果 有 针对 EditText 的 监听 器 《比如 

在 onCreate(...) 或 onCreateView(...) 当 中 ) ， 那 

么 TextWatcher 的 

beforeTextChanged(. ..)、onTextChanged(. .. ) 和 
afterTextChanged(...) 函 数 就 会 执行 。 在 onSstart() 里 设置 监 
ee eee 因为 视图 状态 恢复 后 才 会 触发 监听 


接 下 来 处 理 Button 部 件 ， 让 它 显示 crime 的 发 生日 期 ， 如 代码 清单 
8-9 所 示 。 


代码 清单 8-9 ”设置 Button 文 字 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 
private lateinit var titleField: EditText 
private lateinit var dateButton: Button 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view = inflater.inflate(R.layout.fragment crime, container 


titleField - view.findViewById(R.id.crime title) as EditText 
dateButton - view.findViewById(R.id.crime date) as Button 


dateButton.apply ( 
text = crime.date.toString() 
isEnabled - false 

j 


return view 


禁用 Button 按 钮 ， 确 保 它 不 会 响应 用 户 点 击 。 按 钮 应 处 于 灰色 状 
态 ， 这 样 用 户 一 看 就 知道 按钮 是 不 可 以 点 击 的 。 在 第 13 章 
中 ，Button 按 钮 会 重新 启用 ， 并 允许 用 户 随 意 选 择 crime 日 期 。 


最 后 处 理 CheckBox 部 件 。 在 onCreateView(...) 里 引用 它 ， 然 后 
在 onSstart() 里 设置 监听 器 ， 根 据 用 户 操作 ， 更 新 
solvedCheckBox 状 态 ， 如 代码 清单 8-10 所 示 。 虽 然 CheckBox 部 件 
的 监 昕 器 不 会 因 fragment 的 状态 恢复 而 触发 ， 但 把 它 放 

在 onStart() 里 ， 代 人 码 逻 辑 会 更 清楚 ， 后 续 也 更 容易 查找 。 


代码 清单 8-10 ”监听 CheckBox 的 变化 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 

private lateinit var titleField: EditText 
private lateinit var dateButton: Button 
private lateinit var solvedCheckBox: CheckBox 


override fun onCreateView( 


inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view = inflater.inflate(R.layout.fragment crime, container 


titleField - view.findViewById(R.id.crime title) as EditText 
dateButton - view.findViewById(R.id.crime date) as Button 
solvedCheckBox = view.findViewById(R.id.crime solved) as Check 


} 


override fun onStart() { 


titleField.addTextChangedListener(titleWatcher) 


solvedCheckBox.apply { 
setOnCheckedChangeListener (  , isChecked -> 
crime.isSolved - isChecked 


CrimeFragment 类 的 代码 实现 部 分 完成 了 ， 但 现在 还 不 能 运行 应 用 
Bea FA Fi TE A SiS 这 是 因为 fragment 自 己 无 法 在 屏幕 上 显 
示 视 图 ， 怎 么 办 ? 把 CrimeFragment 添 加 给 MainActivity。 


8.6 托管 UI fragment 
为 托管 UI fragment，activity 必 须 : 


。 在 其 布局 中 为 fagment 的 视图 安排 位 置 ; 
。 管理 fragment 实 例 的 生命 周期 。 


可 以 写 代码 把 fragment 添 加 给 activity。 这 样 ， 你 自己 便 能 决定 何 时 添加 
fragment， 以 及 随后 可 以 完成 何 种 任务 。 你 也 可 以 移 除 fragment， 用 其 
他 fragment 代 蔡 当 前 fragment， 甚 至 重新 添加 已 移 除 的 fragment。 
具体 代码 稍 后 会 给 出 。 现 在 ， 移 来 定义 MainActivity 的 布局 。 


8.6.1 定义 容器 视图 


虽然 已 选择 在 托管 activity 代 码 中 添加 UI fragment， 但 还 是 要 在 activity 视 
图 层级 结构 中 为 fragment 视 图 安排 位 置 。 找 到 并 打开 MainActivity 的 布 
局 文件 reylayoutactivity_main.xml， 使 用 一 个 FrameLayout 蔡 换 默 认 布 
局 。 完 成 后 的 XML 文件 应 如 代码 清单 8-11 所 示 。 


代码 清单 8-11 创建 fragment 容 器 布局 


(res/layout/activity_main.xml ) 


<FrameLayout 
xmlns: android="http: //schemas. android. com/apk/res/android" 
android: id="@t+id/fragment_container" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 


FrameLayout 是 服务 于 CrimeFragment 的 容器 视图 。 注 意 该 容器 视图 
是 个 通用 视图 ， 不 单单 用 于 CrimeFragment 类 ， 还 可 以 用 它 托管 其 他 的 


fragment。 


注意 ， 当 前 的 activity_main.xml 布 局 文件 仅 由 一 个 服务 于 单个 fragment 的 
容器 视图 组 成 ， 但 托管 activity 布 局 本 里 也 可 以 非常 复杂 。 除 自身 部 件 
外 ， 托 管 activity 布 局 还 可 定义 多 个 容器 视图 。 


运行 CriminalIntent 应 用 验证 实现 代码 。 你 会 看 到 一 个 包含 应 用 名 的 
空 FrameLayout， 如 图 8-12 所 示 。 


9:00 b dt | 


Criminallntent 


«4 © m 


图 8-12 一 个 空 的 FrameLayout 

现在 只 能 看 到 一 个 空 的 FrameLayout， 因 为 MainActivity 还 没有 托管 
任何 fragment。 稍 后 ， 我 们 会 编写 代码 ， 将 fragment 的 视图 放置 

到 FrameLayout 中 。 不 过 ， 首 先 要 有 一 个 fragment。 


(TZ Android Studio 当 前 对 activity 的 配置 ， 应 用 顶部 的 工具 栏 默 认 就 有 。 
关于 如 何 定制 工具 栏 ， 请 阅读 第 14 章 。) 


8.6.2” 问 FragmentManager 中 添加 UI fragment 


自 Honeycomb 开 始 引 入 Fragment 类 的 时 候 ， 为 协同 工作 ，Activity 类 
中 便 添 加 了 FragmentManager 关 。 如 图 8-13 所 示 ， 这 

个 FragmentManager 类 具体 管 p MP SUA tra omont Bl FU Alfragmentt4% 
回 退 栈 〈 稍 后 会 学 习 ) 。 它 负责 将 fragment 视 图 添加 到 activity 的 视图 层 


级 结构 中 。 


FragmentManager 


事务 回 退 栈 Co 队列 


FragmentTransacton | | fragment | 


图 8-13 ”FragmentManager 图 解 


就 CriminalIntent 应 用 来 说 ， 我 们 只 需要 关心 FragmentManager 管 理 的 
fragment 队 列 。 


01. fragment 事 务 
获取 FragmentManager 之 后 ， 再 获取 一 个 fragment 交 给 它 管理 ， 如 
代码 清单 8-12 所 示 。 《现在 只 需 对 照 添加 ， 稍 后 会 逐 行 解读 代 
码 。) 


代码 清单 8-12 添加 一 个 CrimeFragment (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


val currentFragment - 
supportFragmentManager.findFragmentById(R.id.fragment cont 


if (currentFragment -- null) ( 
val fragment - CrimeFragment() 
supportFragmentManager 
.beginTransaction() 
.add(R.id.fragment container, fragment) 
. commit() 


} 


为 了 以 代码 的 方式 把 fragmenti 示 加 给 activity， 这 里 显 式 调用 了 
activity 的 FragmentManager。 我 们 使 

用 supportFragmentManager 属 性 就 能 获取 activity 的 fragment 管 理 
器 。 因 为 使 用 了 Jetpack 库 版 本 的 fragment 和 AppCompatActivity 
类 ， 所 以 这 里 用 的 是 supportFragmentManager。 前 级 support 表 明 
它 最 初 来 自 v4 文 持 库 。 现 在 ， 文 持 库 已 重新 打包 为 androidx 放 在 
Jetpack 库 里 。 


以 上 代码 中 ， 获 取 fragment 不 难 理解 。add(. . .) 函 数 及 其 相关 代码 
才 是 重点 。 这 段 代 码 创 建 并 提交 了 一 个 fragment 事 务 : 


if (currentFragment == null) { 
val fragment = CrimeFragment() 
supportFragmentManager 


.beginTransaction() 
.add(R.id.fragment container, fragment) 
. commit() 


fragment 事 务 被 用 来 添加 、 移 除 、 附 加 、 分 离 或 替换 fragment 队 列 
中 的 fragment。 它 们 允许 你 按 组 执行 多 个 操作 ， 例 如 ， 同 时 添加 多 
个 fragment 到 不 同 的 视图 容 右 里 。 这 是 使 用 fragment 动 态 组 装 和 重 
新 组 装 用 户 界面 的 关键 。 


FragmentManager 维 护 着 一 个 fragment 事 务 回 退 栈 ， 你 可 以 查看 、 
历数 它们 。 如 果 fragment 事 务 包含 多 个 操作 ， 那 么 在 事务 从 回 退 栈 
里 移 除 时 ， 其 批量 操作 也 会 回 退 。 基 于 这 个 原因 ，UI 状 态 更 好 控制 
Le 


FragmentManager. beginTransaction( ) HAC Gi EFFI [n] 
FragmentTransaction 实 例 。FragmentTransaction 类 支持 流 接 
L1 (fluent interface) 的 链 式 函数 调用 ， 以 此 配 

置 FragmentTransaction 再 返回 它 。 因 此 ， 以 上 灰 底 代码 可 解读 
为 : “创建 一 个 新 的 fragment 事 务 ， 执 行 一 个 fragment 添 加 操作 ， 然 
后 提交 该 事务 。” 


add(...) 函 数 是 整个 事务 的 核心 ， 它 有 两 个 参数 : 容器 视图 资源 
ID 和 新 创建 的 CrimeFragment。 容 器 视图 资源 ID 你 应 该 很 熟悉 
了 ， 它 是 定义 在 activity_main.xml 中 的 FrameLayout 部 件 的 资源 
ID. 


容器 视图 资源 ID 的 作用 有 : 
e 告诉 FragmentManager，fragment 视 图 应 该 出 现在 activity 视 图 
的 什么 位 置 ; 
e 唯一 标识 FragmentManager 队 列 中 的 fragment。 


如 需 从 FragmentManager 中 获取 CrimeFragment， 使 用 容器 视图 
资源 ID 了 就 行 了 : 


val currentFragment = 
supportFragmentManager.findFragmentById(R.id.fragment container) 


if (currentFragment -- null) ( 
val fragment - CrimeFragment() 
supportFragmentManager 
.beginTransaction() 
.add(R.id.fragment container, fragment) 
. commit() 


FragmentManager 使 用 FrameLayout 的 资源 ID 来 识 

别 CrimeFragment， 这 看 上 去 可 能 有 点 怪 。 但 实际 上 ， 使 用 容器 视 
图 资源 ID 识别 UI fragment 就 是 FragmentManager 的 一 种 内 部 实现 

机 制 。 如 果 要 同 activity 中 添加 多 个 fragment， 通 常 需要 分 别 为 每 个 
fragment 创 建 具有 不 同 ID 的 各 种 容器 。 


现在 ， 从 头 至 尾 对 代码 清单 8-12 中 的 新 增 代 码 做 一 个 总 结 。 


首先 ， 使 用 R.id.fragment_container 的 容器 视图 资源 ID， 
向 FragmentManager 请 求 并 获取 fragment。 如 果 要 获取 的 fragment 
在 队列 中 ，FragmentManager 就 直接 返回 它 。 


为 什么 要 获取 的 fragment 可 能 已 在 队列 中 了 了 呢 ? 前 面 说 过 ， 设 备 旋 
转 或 回收 内 存 时 ，Android 系 统 会 销毁 MainActivity， 而 后 重建 
I, si MainActivity.onCreate(Bundle?) pi. activity% 


销毁 时 ， 它 的 FragmentManager 会 将 fragment 队 列 保存 下 来 。 这 
样 ，activity 重 建 时 ， 新 的 FragmentManager 会 首先 获取 保存 的 队 
列 ， 然 后 重建 fagment 队 列 ， 从 而 恢复 到 原来 的 状态 。 


当然 ， 如 果 指 定 容 器 视图 资源 ID 的 fragment 不 存在 ， 则 fragment 变 
量 为 空 值 。 这 时 应 该 新 建 CrimeFragment， 并 启动 一 个 新 的 
fragment 事 务 ， 将 新 建 fragment 添 加 到 队列 中 。 


MainActivity 现 在 托管 着 CrimeFragment。 运 行 CriminalIntent 尿 
用 验证 这 一 点 ， 应 该 可 以 看 到 定义 在 fragment_crime.xml 中 的 视图 ， 
如 图 8-14 所 示 。 
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图 8-14 MainActivity 托 管 的 CrimeFragment 视 图 


02. FragmentManager 与 fragment 生 命 周 期 


图 8-15 展 示 了 fragment 的 生命 周期 。fragment 有 类 似 于 activity 的 生命 
周期 : 有 同样 的 停止 、 暂 停 和 运行 状态 ， 有 可 以 履 盖 的 函数 ， 让 你 
能 在 东 些 关键 时 点 执行 特定 任务 ， 而 且 ， 这 些 函 数 大 多 和 activity 生 
命 周 期 相对 应 。 


运行 
onPause() 
暂停 onResumel ue 
*—~— activity/fragment 
RAIS 
重 返 前 台 onstop0 
停止 onStart) «—____ activity/fragment 
次 可 见 
再 次 可 多 onDestroyView() 
创建 onActivityCreated(Bundle?) 
activity 关 闭 
onAttach(Context?), onCreate(Bundle?), onDestroy(), onDetach() 
onCreateView(...), onViewCreated(...) 
(全 部 在 setContentView() 函 数 中 调用 ) 
t 
启动 销毁 


18-15 fragment 和 后 命 周 期 


这 个 对 应 太 重 要 了 。 因 为 fragment 代 表 activity 工 作 ， 所 以 它 的 状态 
要 能 反映 activity 状 态 。 因 此 ， 需 要 对 应 的 生命 周期 函数 处 理 activity 
PLETE 


activity 的 生命 周期 函数 由 操作 系统 负 贡 调用 ， 而 fragment 的 生命 周 
期 函数 由 托管 activity 的 FragmentManager 负 责 调用 。 对 于 activity 
用 来 管理 事务 的 fragment， 操 作 系 统 概 不 知情 。 添 加 fragment 供 
FragmentManager 管 理 

I, onAttach(Context?). onCreate(Bundle?) il 
onCreateView(. . .) 函 数 会 被 调用 。 


托管 activity 的 onCreate(Bundle?) 函 数 执行 

后 ，onActivityCreated(Bundle?) 函 数 也 会 被 调用 。 因 为 是 
fEMainActivity.onCreate(Bundle?) MACH 

加 CrimeFragment， 所 以 fragment 被 添加 后 ， 该 函数 会 被 调用 。 


在 activity 处 于 运行 状态 时 ， 添 加 fragment 会 发 生 什 么 昵 ? 这 种 情况 
下 ，FragmentManager 会 立即 驱赶 fragment， 调 用 一 系列 必要 的 生 
命 周 期 函数 ， 快 速 跟 上 activity 的 步伐 〈 与 activity 的 最 新 状态 保持 同 
步 ) 。 例 如 ， 问 处 于 运行 状态 的 activity 中 添加 fragment 时 ， 以 下 
fragment 和 后 命 周 期 函数 会 被 依次 调 

H: onAttach(Context?). onCreate(Bundle?). onCreateVie 
以 及 onResume( ) 。 


一 旦 追 上 ， 托 管 activity 的 FragmentManager 就 会 边 接收 操作 系统 
的 调用 指令 ， 边 调用 其 他 生命 周期 函数 ， 让 fragment 与 activity 保 持 
步调 一 致 。 


8.7 ”采用 fragment 的 应 用 架构 


设计 应 用 时 ， 正 确 使 用 fragment 非 常 重要 。 然 而 ， 许 多 开发 者 学 习 了 了 
fragment 之 后 ， 为 了 复 用 部 件 ， 只 要 可 能 ， 就 直接 使 用 fragment。 这 实 
际 是 在 滥用 fragment。 


使 用 fragment 的 本 意 是 封装 关键 部 件 以 方便 复 用 。 这 里 所 说 的 关键 部 

件 ， 是 针对 应 用 的 整个 屏幕 来 讲 的 。 如 果 单 屏 就 使 用 大 量 fragment， 不 
仅 应 用 代码 充斥 着 fragment 事 务 处 理 ， 模 块 的 职责 分 工 也 会 不 清晰 。 如 
果 有 很 多 零碎 小 部 件 要 复 用 ， 比 较 好 的 架构 设计 是 使 用 定制 视图 〈 使 
用 View 子 类 ) 。 


总 之 ， 一 定 要 合理 使 用 fragment。 如 图 8-16 所 示 ， 实 践 证 明 ， 应 用 单 屏 
最 多 使 用 2 一 3 个 fragment。 
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使 用 fragment 的 理由 
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使 用 fragment 一 直 是 Android 社 区 争论 的 焦点 。 有 些 人 认为 ，fragment 及 
其 生命 周期 会 让 项 目 变 得 复杂 ， 因 而 从 不 用 它 。 我 们 认为 ， 这 种 做 法 过 
于 极端 ， 因 为 有 好 几 个 Android API， 比 如 ViewPager 和 JetPack 导 航 库 ， 
都 依赖 于 fragment。 所 以 ， 如 果 要 用 这 些 API， 就 得 使 用 fragment。 


除了 使 用 依赖 fragment 的 API 外 ， 对 于 需求 复杂 的 大 型 应 用 而 言 ， 
fragment 还 是 很 好 用 的 。 人 至 于 简单 的 单 屏 应 用 ，fragment 及 其 生命 周期 
确实 显得 有 点 复杂 了 ， 因 此 没 必 要 使 用 。 


不 幸 的 是 ， 经 验 表 明 ， 后 期 添加 fragment 就 如 同 掉 进 泥 坑 。 从 activity 管 
理 用 户 界面 调整 到 由 activity 托 管 UI fragment 虽 然 不 难 ， 但 会 有 一 大 堆 恼 
人 的 问题 等 着 你 。 你 也 可 能 会 想 让 部 分 用 户 界 面 仍 由 activity 管 理 ， 部 分 
用 户 界 面 改 用 fragment 管 理 ， 这 只 会 让 事情 更 糟 。 哪 些 不 改 ， 哪 些 要 
改 ， 光 厘清 这 些 问题 就 够 你 头痛 的 了 。 显 然 ， 从 一 开始 就 使 用 fragment 
更 容易 ， 既 不 用 返工 ， 也 不 会 出 现 厘 不 清 哪 个 部 分 使 用 了 哪 种 视图 控制 
风格 这 种 事 了 。 


因而 ， 对 于 是 个 使 用 fragment， 我 们 有 上 自己 的 原则 : 总 是 使 用 
fragment。 如 果 你 知道 要 开发 的 应 用 很 简单 ， 多 论 力气 去 用 fragment 就 
不 太 值 得 了 了 ， 因 此 不 用 也 轻 。 对 于 大 型 应 用 ，fragment 帝 来 的 灵活 性 能 
抵消 其 复杂 性 ， 给 项 目 带 来 的 好 处 显而易见 。 


从 现在 开始 ， 本 书 大 部 分 应 用 开发 会 使 用 fragment。 不 过 ， 假 如 某 一 章 
只 需 开 发 一 个 小 应 用 ， 简 单 起 见 ， 束 不 用 fragment 了 了。 然而， 对 于 稍 复 
林 些 的 应 用 ， 不 用 多 想 ， 肯 定 要 用 fragment。 这 样 既 方 便 应 用 的 未 来 扩 
展 ， 也 能 让 你 获得 足够 多 的 开发 体验 。 


第 9 章 使 用 RecyclerView 显 示 
列表 


当前 ，CriminalIntent 应 用 的 模型 层 仅 包含 一 个 Crime 实 例 。 本 章 ， 我 们 
将 更 新 CriminalIntent 应 用 以 支持 显示 crime 列 表 。 列 表 会 显示 每 个 Crime 
实例 的 标题 及 其 发 生日 期 ， 如 图 9-1 所 示 。 


9:00 | 


Criminallntent 


Crime #0 
Wed Nov 28 17:36:53 EST 201 


o0 


Crime #1 
Wed Nov 28 17:36:53 EST 2018 


Crime #2 
Wed Nov 28 17:36:53 EST 2018 


Crime #3 
Wed Nov 28 17:36:53 EST 2018 


Crime #4 
Wed Nov 28 17:36:53 EST 2018 


Crime #5 
Wed Nov 28 17:36:53 EST 2018 


Crime #6 
Wed Nov 28 17:36:53 EST 201 


co 


Crime #7 
Wed Nov 28 17:36:53 EST 201 


co 


Crime #8 
Wed Nov 28 17:36:53 EST 201 


[es] 


Crime #9 
Wed Nov 28 17:36:53 EST 201 


co 


Crime #10 
Wed Nov 28 17:36:53 EST 201 


co 


图 9-1 crime 列表 


图 9-2 是 CriminalIntent 应 用 在 本 章 的 整体 规划 图 。 
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应 用 控制 层 将 新 增 一 个 ViewModel 对 象 ， 用 来 封装 屏 显 数 
据 。CrimeListViewMode1 用 来 存储 Crime 对 象 列 表 。 


显示 crime 列 表 需 在 应 用 控制 器 层 新 增 一 个 
fragment: CrimeListFragment。MainActivity 会 托管 
CrimeListFragment 实 例 ， 让 其 在 屏幕 上 显示 crime 列 表 。 


(图 9-2 中 怎么 没有 CrimeFragment 呢 ? 它 是 与 明细 视图 相关 的 类 ， 所 
以 这 里 没有 显示 。 在 第 12 章 中 ， 我 们 将 学 习 如 何 关 联 CriminalIntent 应 用 
的 列表 视图 和 明细 视图 。) 


在 图 9-2 中 ， 也 可 以 看 到 与 MainActivity 和 CrimeListFragment 关 联 
的 视图 对 象 。activity 视 图 由 包含 fragment 的 FrameLayout 组 成 。 
fragment 视 图 由 一 个 RecyclerView 组 成 。 稍 后 会 学 习 RecyclerView 
类 

JX o 


9.1 添加 新 Fragment 和 ViewModel 


首先 ， 我 们 需要 添加 一 个 ViewMode1 来 存储 Crime 对 象 集合 。 第 4 章 告诉 
我 们 ，ViewMode1 类 属于 生命 周期 扩展 库 。 所 以 ， 先 在 app/build.gradle 
文件 里 添加 需要 的 生命 周期 扩展 依赖 ， 如 代码 清单 9-1 所 示 。 


代码 清单 9-1 添加 生命 周期 扩展 依赖 Capp/build.gradle ) 


dependencies { 


implementation ‘androidx.appcompat:appcompat:1.1.0-alpha@2' 


implementation 'androidx.core:core-ktx:1.1.0-alpha04' 
implementation 'androidx.lifecycle:lifecycle-extensions:2.0.0' 


添加 完成 后 ， 别 忘 了 同步 Gradle 文 件 。 


接 下 来 ， 新 建 一 个 名 为 CrimeListViewModel 的 Kotlin 类 ， 让 其 继 
承 ViewMode1， 再 添加 一 个 存储 Crime 列 表 的 属性 。 在 init 初 始 化 块 里 
批量 生成 数据 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 ”生成 100 个 Crime (CrimeListViewModel.kt) 


class CrimeListViewModel : ViewModel() { 
val crimes = mutableListOf<Crime>() 


init { 
for (i in 6 until 100) ( 


val crime = Crime() 
crime.title = "Crime #$i" 
crime.isSolved = i % 2 == @ 
crimes += crime 


最 后 ， 新 建 List 将 包含 用 户 自 建 的 Crime， 用 户 可 自由 存 取 它 们 。 现 
在 ， 先 批量 存 入 100 个 乏味 的 Crime 对 象 。 


CrimeListViewMode1 并 不 是 一 个 持久 化 保存 数据 的 方案 ， 但 它 确实 封 
装 了 CrimeListFragment 视 图 要 显示 的 全 部 数据 。 第 11 章 会 学 习 持久 
化 数据 保存 方法 ， 更 新 CriminalIntent 应 用 ， 把 crime 列 表 保 存在 数据 库 


H 


下 一 步 是 创建 CrimeListFragment 类 ， 将 其 与 CrimeListViewModel 
Wok. Dlandroidx.fragment.app.Fragment7j- 25, ibAndroid 
Studio 创 建 CrimeListFragment 类 文件 ， 如 代码 清单 9-3 所 示 。 


代码 清单 9-3 ”实现 CrimeListFragment (CrimeListFragment.kt ) 


private const val TAG = "CrimeListFragment" 
class CrimeListFragment : Fragment() { 
private val crimeListViewModel: CrimeListViewModel by lazy { 


ViewModelProviders.of(this).get(CrimeListViewModel::class.java) 


} 


override fun onCreate(savedInstanceState: Bundle?) { 


super .onCreate(savedInstanceState) 
Log.d(TAG, "Total crimes: ${crimeListViewModel.crimes.size}") 


} 


companion object { 
fun newInstance(): CrimeListFragment { 
return CrimeListFragment() 


“Hv, CrimeListFragmentitz tax, Aid 
录 CrimeListViewModel 中 存放 的 crime 对 象 数 。 


以 上 代码 中 ， 为 了 让 activity 调 用 获取 fragment 实 例 ， 我 们 添加 了 一 
个 newInstance(...) 了 水 数 。 这 是 个 不 错 的 做 法 ， 和 在 GeoQuiz 里 使 
用 newIntent() 很 相似 。 如 何 把 数据 传递 给 fragment， 留 待 第 12 章 介 
2n 


ViewModel/t fy 5] 9] 5; fragment 


和 activity 配 对 使 用 ViewMode1 有 什么 样 的 生命 周期 ， 你 在 第 4 章 已 经 看 
到 了 。 现 在 ， 和 fragment 配 合 使 用 ，ViewMode1l 的 生命 周期 就 有 点 不 一 
样 了 。 尽 管 还 是 只 有 创建 和 销毁 〈 或 不 存在 ) 这 两 种 状态 ， 但 它 现 在 是 


和 fragment 的 生命 周期 紧 紧 绑 定 了 。 


只 要 fragment 视 图 还 在 屏幕 上 ，ViewMode1 就 会 一 直 处 于 活动 状态 。 即 
使 因 设备 旋转 当前 fragment 实 例 不 存在 了 ，ViewModel 依 然 能 保留 下 
来 ， 还 可 以 供 新 的 fragment 实 例 使 用 。 


如 果 当 前 fragment 被 销毁 ， 那 么 其 关联 ViewMode1 也 随 之 销毁 。 这 在 用 
户 按 回 退 键 退 出 当前 应 用 界面 时 就 会 发 生 。 另 外 ， 在 托管 activity 使 用 不 
同 的 fragment 蔡 换 当 前 fragment 时 也 是 如 此 。 也 就 是 说 ， 即 使 托管 
activity 还 在 ， 但 被 托管 的 fragment 和 其 关联 ViewModel 都 会 被 销毁 ， 
为 它们 没 用 了 。 


不 过 ， 在 你 把 fragment 事 务 谎 加 到 回 退 栈 时 ， 即 便 托 管 activity 使 用 其 他 
fragment 蔡 换 了 当前 fragment， 当 前 fragment 实 例 和 它 的 关联 ViewMode1l 
也 不 会 被 销毁 。 这 是 一 个 很 特殊 的 情况 。 应 用 之 前 的 状态 会 恢复 : UR 
用 户 按 了 回 退 键 ，fragment 事 务 会 回 退 ， 被 蔡 换 的 原始 fragment 视 图 会 
重新 出 现在 屏幕 上 ，ViewMode1 里 的 数据 也 得 以 保留 。 


接 下 来 ， 更 新 MainActivity， 让 其 托管 CrimeListFragment， 如 代码 
清单 9-4 所 示 。 


代码 清单 9-4 使 用 fragment 事 务 添 
加 CrimeListFragment (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


if (currentFragment == null) { 
val fragment = 


一 CrimeListFragment .newInstance() 
supportFragmentManager 
.beginTransaction() 
.add(R.id.fragment container, fragment) 
. commit() 


当前 ， 我 们 硬 编码 让 MainActivity 只 显示 CrimeListFragment。 在 第 
12 章 中 ， 我 们 还 会 更 新 MainActivity， 让 其 根据 用 户 应 用 内 导航 需 


要 ， 动 态 显 示 CrimeListFragment 和 CrimeFragment。 


运行 CriminalIntent 应 用 ， 你 会 看 到 MainActivity 的 FrameLayout 托 管 
了 一 个 无 内 容 的 CrimeListFragment， 如 图 9-3 所 示 。 
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Criminallntent 


图 9-3 无 内 容 的 MainActivity 界 面 


搜索 CrimeListFragment 的 Logcat 输 出 日 志 ， 你 会 看 到 一 条 日 志 给 出 了 


总 的 Crime 对 象 数 。 


2019-02-25 15:19:39.950 26140-26140/com.bignerdranch.android.criminalintent 


D/CrimeListFragment: Total crimes: 100 


9.2 ”添加 RecyclerView 


我 们 需要 CrimeListFragment 回 用 户 展 示 crime 列 表 ， 这 需要 用 到 一 
个 RecyclerView 类 。 


RecyclerView 类 在 另 一 个 Jetpack 库 里 ， 要 使 用 它 ， 首 先 要 添 
加 RecyclerView 库 依赖 ， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 ”添加 RecyclerView 依 赖 Capp/build.gradle) 


dependencies { 


implementation 'androidx.lifecycle:lifecycle-extensions:2.0.0' 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 


同样 ， 添 加 完 记 得 同步 Gradle 文 件 。 


RecyclerView 视 图 需 在 CrimeListFragment 的 布局 文件 中 定义 ， 所 以 
需要 先 创建 一 个 布局 文件 。 如 图 9-4 所 示 ， 创 建 一 个 布局 资源 文件 ， 命 
名 为 fragment_crime_list，Root element 指 定 为 
androidx.recyclerview.widget.RecyclerView. 


® ® New Resource File 


File name: fragment_crime_list 
Root element: androidx.recyclerview.widget.RecyclerView 
Source set: main v 


Directory name: layout 


Available qualifiers: Chosen qualifiers: 


$3 Country Code 
>> 


@: Network Code 
© Locale 


[3 Layout Direction 
ER Gmallaeet Screen Width 


图 9-4 添加 CrimeListFragment 布 局 文件 


如 代码 清单 9-6 所 示 ， 打 开 layout/fragment_crime_list.xml 文 件 ， 给 
RecyclerView 添 加 ID 属 性 。 既 然后 面 不 再 给 RecyclerView 添 加 任何 
doux 了 ， 那 么 这 里 删除 闭合 标签 ， 改 用 上 自 闭 合 标签 。 


代码 清单 9-6 ”在 布局 文件 中 添 


加 Rec yclerView (layout/fragment_crime_list.xml ) 


<androidx.recyclerview.widget.RecyclerView 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@+id/crime_recycler_view" 
android: layout_width="match_parent" 


roids] Reiehteaateh T 


android: layout_height="match_parent"/> 


CrimeListFragment 的 视图 搞定 了 ， 接 下 来 束 可 以 用 了 。 如 代码 清单 9- 
7 所 示 ， 修 改 CrimeListFragment 类 ， 使 用 fragment_crime_list 布 局 ， 找 
到 其 中 的 RecyclerView。 


代码 清单 9-7 为 CrimeListFragment 配 置 视 图 
(CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


private lateinit var crimeRecyclerView: RecyclerView 


private val crimeListViewModel: CrimeListViewModel by lazy { 
ViewModelProviders.of(this).get(CrimeListViewModel::class.java) 


} 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d(TAG, "Total crimes: ${crimeListViewModel.crimes.size}") 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view - inflater.inflate(R.layout.fragment crime list, container 
crimeRecyclerView - 
view.findViewById(R.id.crime recycler view) as RecyclerView 


crimeRecyclerView.layoutManager - LinearLayoutManager(context) 


return view 


可 以 看 到 ， 以 上 代码 中 ， 新 创建 的 RecyclerView 还 需要 一 个 名 
为 LayoutManager 的 对 象 。 没 有 它 的 支持 ，RecyclerView 将 无 法 工 
Ts 如 果 你 筷 了 这 一 步 ， 代码 会 HA Int © 


RecyclerViewA 4 AGE TE Ste EBA. EFEX 
项 工作 委托 给 LayoutManager 处 理 。LayoutManager 不 仅 要 安排 列表 
项 出 现 的 位 置 ， 还 负责 定义 如 何 滚 屏 。 因 此 ， 没 有 LayoutManager 在 
场 ， 让 RecyclerView 做 这 些 事 ， 立马 就 会 出 大 问 题 。 


Android 操 作 系 统 有 好 几 个 LayoutManager 实 现 版 本 可 选 ， 第 三 方 库 也 
有 一 些 实现 版 本 。 这 里 ， 我 们 用 的 是 LinearLayoutManager， 它 可 以 
竖 直 列表 的 形式 摆 放 列表 项 。 后 面 我 们 还 会 使 


用 GridLayoutManager， 以 网 格 的 形式 摆 放 列表 项 。 


9.3 ”创建 列表 项 视图 布局 


RecyclerView 是 ViewGroup 的 子 类 。 它 显示 的 列表 项 都 是 一 个 个 View 
子 对 象 ， 因 此 又 叫 列表 项 View。 每 一 个 列表 项 view 展 现 的 是 数据 集合 里 
的 单个 对 象 〈 在 CriminalIntent 应 用 里 ， 指 的 是 crime 集 合 里 的 某 项 crime 

事件 ) 。 根 据 列 表 项 要 显示 的 内 容 ， 这 些 View 子 对 象 可 简单 可 复杂 。 


首先 来 实现 简单 的 列表 项 显示 ， 即 每 个 列表 项 只 显示 crime 事 件 的 标题 
和 日 期 ， 如 图 9-5 所 示 。 
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图 9-5 ”显示 子 View 的 RecyclerView 


如 同 CrimeFragment 的 视图 ， 显 示 在 RecyclerView 上 的 列表 项 都 有 上 自 
己 的 视图 层级 结构 。 准 确 地 说 ， 每 一 行 的 View 对 象 都 是 一 个 包含 两 


个 TextView 部 件 的 LinearLayout。 


创 建 列表 项 视图 布局 和 创建 activity 或 fragment 视 图 布局 没什么 不 同 。 在 
MATA BOA, ARETE reslayout 目 录 ， 选 择 New > Layout resource 
file 菜 单项 。 在 弹出 的 对 话 框 中 ， 命 名 布局 文件 为 list_item_crime， 设 置 
根 元 素 为 LinearLayout， 点 击 OK 按 钮 完成 。 


如 代码 清单 9-8 所 示 ， 更 新 布局 文件 给 LinearLayout 添 加 边 距 属性 ， 再 
添加 两 个 TextView 和 定义 。 


代码 清单 9-8 ”更 新 列表 项 布局 文件 Cayout/list_item_crime.xml ) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 


rode] ER T 


android:layout height-"wrap content" 
android:padding-"8dp"» 


«TextView 
android: id="@+id/crime_title" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: text="Crime Title"/» 


<TextView 
android: id="@+id/crime_date" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: text="Crime Date"/> 


</LinearLayout> 


查看 预览 设计 界面 ， 你 会 看 到 已 创建 的 一 个 长 条 形 列表 项 视图 。 


9.4 ViewHolder 实 现 


RecyclerView 的 任务 仅 限 于 回收 和 摆 放 屏幕 上 的 View。 列 表 项 View 能 
够 显示 数据 还 离 不 开 男 外 两 个 类 的 支持 : ViewHolder 子 类 和 Adapter 


子 类 《〈 详 见 下 一 节 ) 。ViewHolder 会 引用 列表 项 视图 (有 时 也 会 引用 
列表 项 视图 里 的 茶 个 具体 部 件 ) 。 


如 代码 清单 9-9 所 示 ， 继 承 RecyclerView.ViewHolder， 
在 CrimeListFragment 里 添加 一 个 内 部 类 。 


代码 清单 9-9 ViewHolder 登 场 (CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 


} 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view) { 


CrimeHolder 的 构造 函数 首先 接收 并 保存 view， 然 后 将 其 作为 值 参 传递 
给 RecyclerView.ViewHolder 的 构造 函数 。 这 样 ， 这 个 ViewHolder 基 
类 的 一 个 名 为 itemView 的 属性 就 能 引用 列表 项 视图 了 ， 如 图 9-6 所 示 。 


ViewHolder 


itemView 


图 9-6 ViewHolder 和 它 的 jtemView 属 性 


RecyclerView 并 不 会 创建 View， 它 只 会 创建 ViewHolder。 从 图 9-7 可 
以 看 出 ， 是 ViewHolder 融 着 其 引用 着 的 itemView 展 现 一 行 行列 表 项 
的 。 
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图 9-7 可 视 化 的 ViewHolder 


如 果 列 表 项 View 很 简单 ， 那 么 ViewHolder 的 工作 也 会 相对 简单 。 如 果 
显示 的 列表 项 View 很 复杂 ，ViewHolder 会 处 理 安排 好 各 个 itemView 的 
不 同 部 分 视图 ， 再 以 简单 高 效 的 方式 展现 Crime 项 。( 例 如 ， 每 次 需要 
设置 列表 项 题 头 时 ， 有 ViewHolder 帮 忙 ， 你 就 不 用 通过 查找 列表 项 视 

图 层级 结构 来 找 题 头 文字 视图 了 。) 

如 代码 清单 9-10 所 示 ， 更 新 CrimeHolder， 在 当前 实例 的 itemvView 视 

We nee 将 它们 保存 到 各 自 的 属 
à A, 


代码 清单 9-10 ”在 构造 函数 里 生成 视图 CCrimeListFragment.kt ) 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view) { 


val titleTextView: TextView = itemView.findViewById(R.id.crime title) 


val dateTextView: TextView = itemView.findViewById(R.id.crime date) 


} 


E 


现在 ， 升 级 后 的 CrimeHolder 会 引用 列表 项 题 头 和 日 期 文字 ， 之 后 想 人 
改 它们 的 值 束 很 容易 了 ， 如 图 9-8 所 示 。 
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图 9-8 ViewHolder 图 形 化 


注意 到 了 吗 ?CrimeHolder 假 定 传 给 其 构造 函数 的 视图 都 有 两 

个 TextView 子 视图 。 它 们 的 ID 分 别 是 R.id.crime_ title 和 
R.id.crime date。“ 谁 创建 了 CrimeHolder 实 例 呢 ? 传 给 其 构造 函数 
的 视图 层级 结构 里 表 定 有 我 想 要 的 部 件 吗 ?” 别 急 ， 管 案 稍 后 揭晓 。 


9.5 /JfjAdapter?H 75 RecyclerView 


图 9-7 做 了 简化 ， 隐 藏 了 一 些 信息 。RecyclerView 自 己 不 创建 
ViewHolder， 它 请 Adapter 来 帮忙 。Adapter 是 一 个 控制 器 对 象 ， 其 作 
为 沟通 的 桥 粱 ， 从 模型 层 获 取 数 据 ， 然 后 提供 给 RecyclerView 显 示 。 


Adapter 负 责 : 


e 创建 必要 的 ViewHolder; 
e 绑 定 ViewHolder 至 模型 层 数据 。 


RecyclerVvView 负 责 : 


。 请 Adapter 创 建 ViewHolder:; 
。 请 Adapter 绑 定 ViewHolder 至 具体 的 模型 层 数据 。 


是 时 候 创 建 Adapter 了。 如 代码 清单 9-11 所 示 ， 在 CrimeListFragment 
里 添加 一 个 名 为 CrimeAdapter 的 内 部 类 。 使 用 一 个 主 构造 函数 接收 


crime 集 合 ， 存 入 一 个 变量 中 。 
代码 清单 9-11 创建 CrimeAdapter (CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view) { 


} 


private inner class CrimeAdapter(var crimes: List<Crime>) 
: RecyclerView.Adapter<CrimeHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) 
: CrimeHolder { 
val view = layoutInflater.inflate(R.layout.list_item_crime, par 
return CrimeHolder (view) 


} 


override fun getItemCount() = crimes.size 


override fun onBindViewHolder(holder: CrimeHolder, position: Int) { 
val crime = crimes[ position] 
holder.apply { 
titleTextView.text = crime.title 
dateTextView.text = crime.date.toString() 


fECrimeAdapter#re AMA, Fee uu — T BRI 

Zi: onCreateViewHolder(...). onBindViewHolder(...)fH 

getItemCount(). DEEST (或 避免 拼写 错误 ) ， 可 让 Android 

Studio 上 自动 生成 这 些 履 盖 函 数 。 输 入 初始 行 新 代码 后 ， 把 光标 放 

在 CrimeAdapter 上 ， 然 后 按 Option+Return (Alt+Enter) 快捷 键 。 从 弹 

出 窗口 中 选 Implement members， 然 后 在 Implement members 对 话 框 中 选 

E ST 点 击 OK 按 钮 完成 。 最 后 ， 参 照 代码 清单 9-11 补 全 
容 。 


Adapter.onCreateViewHolder(...) 负 责 创 建 要 显示 的 视图 ， 将 其 去 
装 到 一 个 ViewHolder 里 并 返回 结果 。 这 里 ， 我 们 从 list_item_view.xml 


布局 实例 化 视图 ， 将 其 传递 给 CrimeHolder。 
(onCreateViewHolder(...) 了 水 数 的 参数 现在 可 以 忽略 。 要 在 同 

一 RecyclerView 里 显示 不 同 视 图 时 ， 我 们 才 和 需要 关心 该 如 何 设置 参数 
值 。 详 细 信 息 可 参看 9.10 节 。) 


Adapter .onBindViewHolder(holder: CrimeHolder, position: 
Int) 负 责 将 数据 集 里 指定 位 置 的 crime 数 据 发 送 给 指定 ViewHolder。 这 
里 ， 我 们 首先 从 crime 集 合 里 取出 指定 位 置 的 crime 数 据 ， 然 后 使 用 其 中 
的 题 头 和 日 期 信息 设置 相应 的 TextView 视 图 。 


RecyclerView 想 知道 数据 集 里 到 底 有 多 少数 据 时 ， 会 让 Adapter 调 
用 Adapter .getItemCount() 函 数 。 这 里 ， 啊 应 RecyclerView,， 
getItemCount() 会 返回 crime 数 据 集 里 有 多 少 个 列表 项 要 显示 。 


如 图 9-9 所 示 ，Crime 对 象 是 什么 样 的 或 者 数据 集 里 有 多 少 Crime 对 

象 ，RecyclerView 完 全 不 关心 ， 什 么 也 不 知道 。CrimeAdapter 则 对 这 
些 信息 了 如 指 掌 ， 它 不 仅 知 道 Crime 对 象 的 具体 内 容 ， 还 知道 数据 集 里 
有 多 少 条 要 显示 的 crime 列 表 项 。 


RecyclerView Adapter List<Crime> 


h SORSERRRERMANAHENHDNMRRRANRNANNSNHARAN 1 | 
OrimeHolder — itemView +»! | 
1 onCreateViewHolder (..) 
m onBindViewHolder (..) 


get ItemCount () 


图 9-9 Adapter 是 沟通 的 桥梁 


RecyclerView 需 要 显示 视图 对 象 时 ， 就 会 去 找 它 的 Adapter。 图 9-10 
展示 了 RecyclerView 可 能 发 起 的 会 话 。 


RecyclerView Adapter 
| need a new ， ' 
ViewHolder. : 


onCreateViewHolder(...) : 


OK. 
«inflates item view, 
creates new view 
holder, passes it 
back.» 


iewHolder 


Please populate 
this ViewHolder 
with data at 
index O. 


OK. 
«Gets crime at index 
0. Sets text based 
on that crime.» 


o 


i 
图 9-10 ”生动 有 趣 的 RecyclerView-Adapter 会 话 


首先 ，RecyclerView 会 调用 Adapter 的 
onCreateViewHolder(ViewGroup，Int) 函 数 创 建 ViewHolder 及 其 要 
显示 的 视图 。 此 时 ， Adapter 创 建 并 返 给 RecyclerView 的 
ViewHolder (和 它 的 itemView) 还 没有 数据 。 


然后 ，RecyclerView 会 调用 onBindViewHolder (ViewHolder，Int) 
函数 ， 传 入 ViewHolder 和 Crime 对 象 的 位 置 。Adapter 会 找到 目标 位 置 
的 数据 并 将 其 绑 定 到 ViewHolder 的 视图 上 。 所 谓 绑 定 ， 束 是 使 用 模型 
对 象 数据 填充 视图 。 


整个 过 程 执行 完毕 ，RecyclerView 就 能 在 屏幕 上 显示 crime 列 表 项 了 。 
为 RecyclerView 配 置 adapter 
搞定 了 Adapter， 最 后 要 做 的 就 是 将 它 和 RecyclerView 关 联 起 来 。 实 


现 一 个 设置 CrimeListFragment 的 UI 的 updateUI 函 数 ， 该 函数 会 创建 
CrimeAdapter， 然 后 配置 给 RecyclerView， 如 代码 清单 9-12 所 示 。 


代码 清单 9-12 设置 Adapter (CrimeListFragment.kt ) 


class CrimeListFragment : Fragment() { 


private lateinit var crimeRecyclerView: RecyclerView 
private var adapter: CrimeAdapter? = null 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view - inflater.inflate(R.layout.fragment crime list, container 


crimeRecyclerView - 
view.findViewById(R.id.crime recycler view) as RecyclerVie 


crimeRecyclerView.layoutManager - LinearLayoutManager(context) 


updateUI() 


return view 


} 


private fun updateUI() { 
val crimes = crimeListViewModel.crimes 
adapter = CrimeAdapter (crimes) 
crimeRecyclerView.adapter = adapter 


E ME UI 的 配置 会 更 为 复杂 ， 到 时 会 向 updateUI() 中 添加 


运行 CriminalIntent 应 用 ， 滚 动 查看 RecyclerView 视 图 。 你 应 该 能 看 到 
如 图 9-11 所 示 画 面 。 
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图 9-11 JET ds RecyclerView 


上 下 滑动 ， 你 会 看 到 更 多 的 crime 视 图 在 屏幕 上 滚 进 滚 出 。 每 一 个 看 得 
到 的 CrimeHolder 显 示 的 都 是 完全 一 样 的 Crime 对 象 。〈 如 果 看 到 列表 
项 行 宽 过 大 ， 或 者 一 个 列表 项 只 能 看 到 一 行 数 据 ， 请 仔细 检查 一 

下 LinearLayout 的 layout_height 属 性 值 是 不 是 wrap_content。) 


试 试看 ， 即 便 一 通 狐 滑 ， 列 表 项 应 该 还 是 滚动 得 非常 流畅 。 这 要 归功 于 
onBindViewHolder(...) 函 数 。 任 何 时 候 ， 都 要 尽量 确保 这 个 函数 轻 
巧 、 高 效 。 


9.6 ”循环 使 用 视图 
在 图 9-11 中 ， 可 以 看 到 11 行 View 对 象 。 你 可 以 滑动 屏幕 租 看 所 有 100 个 


crime 列 表 项 。 这 是 不 是 意味 着 内 存 里 要 有 100 个 View 对 象 呢 ? 不 是 ! 因 
为 我 们 有 RecyclerView 帮 人 忙 。 


一 次 为 所 有 列表 项 创建 View 很 容易 将 应 用 搞 垮 。 可 以 想象 ， 真 实 应 用 要 
显示 的 列表 项 远 不 止 100 个 ， 其 内 容 更 复杂 。 另 外 ， 在 屏幕 上 显示 时 ， 
一 个 crime 列 表 项 对 应 一 个 View 就 行 了 。 因 此 ， 完 全 没 必要 同时 准备 100 
个 View， 按 需 创 建 视图 对 象 才 是 比较 合理 的 解决 方案 。 


RecyclerView 了 就 是 这 么 做 的 。 它 只 创建 刚好 充满 屏幕 的 View 对 象 ， 而 
不 是 100 个 。 用 户 涓 动 屏 费时 ， 深 出 屏 秦 的 视图 会 被 回收 利用 。 顾 名 上 思 
义 ，RecyclerView 所 做 的 就 是 回收 再 利用 ， 循 环 往复 。 


这 样 一 来 ， 相 比 onBindViewHolder(ViewHolder， 
Int)，onCreateViewHolder(ViewGroup，Int) 的 调用 就 少 多 

了 。ViewHolder 一 旦 够 用 ，RecyclerView 就 会 停止 调 

用 onCreateViewHolder(...)， 转 而 回收 旧 ViewHolder， 将 其 传 给 
onBindViewHolder (ViewHolder，Int) 使 用 ， 这 样 既 省 时 义 省 内 存 。 


9.7 i55 E 


当前 ， 在 Adapter .onBindViewHolder(...) 函 数 里 ，Adapter 是 把 
crime 数 据 直 接 和 CrimeHolder 的 TextView 视 图 绑 定 的 。 这 么 做 虽然 可 
行 ， 但 最 好 是 把 ViewHolder 和 Adapter 各 自 该 做 的 工作 分 清 。Adapter 
应 尽量 不 插手 ViewHolder 的 内 部 工作 和 细节 。 


因此 ， 我 们 推荐 把 数据 和 视图 的 绑 定 工作 都 放 在 CrimeHolder 里 处 理 。 
如 代码 清单 9-13 所 示 ， 首 先 添加 一 个 存储 Crime 的 属性 ， 再 顺手 把 
TextView 属 性 变 为 私有 ， 然 后 同 CrimeHolder 中 添加 一 

个 bind(Crime) 消 数 ， 处 理 绑 定 工作 。 在 新 添加 函数 里 ， 把 绑 定 的 
crime 对 象 赋值 给 属性 变量 ， 并 设置 titleTextView 和 dateTextView 视 
图 的 显示 文字 。 


代码 清单 9-13 ”实现 bijnd(Crime) 函 数 (CrimeListFragment.kt) 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view) { 


private lateinit var crime: Crime 


private val titleTextView: TextView = itemView. findViewById(R.id.crime 
private val dateTextView: TextView = itemView.findViewById(R.id.crime d 


fun bind(crime: Crime) ( 
this.crime - crime 
titleTextView.text - this.crime.title 
dateTextView.text - this.crime.date.toString() 


现在 ， 只 要 取 到 一 个 要 绑 定 的 Crime，CrimeHolder 就 会 更 新 显 
示 TextView 标 题 视图 和 TextView 日 期 视图 。 


最 后 ， 修 改 CrimeAdapter 类 ， 调 用 bind(Crime) 函 数 。 
次 RecyclerView 要 求 CrimeHolder 绑 定 对 应 的 Crime 时 ， 都 会 调 
用 bind(Crime) 函 数 ， 如 代码 清单 9-14 所 示 。 


代码 清单 9-14 WHH bind(Crime)Kžt CCrimeListFragment.kt) 


private inner class CrimeAdapter(var crimes: List<Crime>) 
RecyclerView.Adapter<CrimeHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): Crim 
} 


override fun onBindViewHolder(holder: CrimeHolder, position: Int) { 
val crime = crimes[ position] 


holder.bind(crime) 


} 


override fun getItemCount() = crimes.size 


再 次 运行 CriminalIntent 应 用 ， 看 到 的 用 户 界面 应 该 与 之 前 一 样 〈 图 9- 
11) 。 


9.8” 啊 应 点 击 


为 了 使 RecyclerView 锦 上 添 花 ，CriminalIntent 应 用 的 列表 项 应 该 能 够 
响应 用 户 的 点 击 。 在 第 12 间 中， 用 户 点 击 列表 项 时 ， 应 用 会 弹出 新 界面 
显示 Crime 明 细 信 息 。 现 在 ， 先 实现 弹出 一 个 Toast 消 息 。 


你 应 该 注意 到 了 ， 虽 然 RecyclerView 功 能 强大 ， 但 它 只 专注 于 做 好 本 
职工 作 。 (这 或 许 值 得 我 们 学 习 。) 因 此， 要 自己 动手 处 理 触 摸 事 件 
了 。 当 然 ， 如 果真 有 需要 ，RecyclerView 也 能 帮 你 转发 触摸 事件 ， 不 
过 大 多 数 时 候 没 有 必要 这 样 做 。 

很 自然 ， 我 们 想到 的 常用 解决 方案 是 设置 OnClickListener 监 听 器 。 
既然 列表 项 视图 都 关联 着 ViewHolder， 那 么 就 可 以 让 ViewHolder 为 它 
监听 用 户 触摸 事件 。 


我 们 通过 修改 CrimeHolder 类 来 处 理 用户 点 击 事件 ， 如 代码 清单 9-15 所 
ZW o 


代码 清单 9-15 ”检测 用 户 点 击 事件 〈CrimeListFragment.kt) 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view), View.OnClickListener { 


private lateinit var crime: Crime 


private val titleTextView: TextView = itemView.findViewById(R.id.crime 
private val dateTextView: TextView = itemView.findViewById(R.id.crime d 


init { 
itemView.setOnClickListener (this) 


} 


fun bind(crime: Crime) ( 
this.crime - crime 
titleTextView.text - this.crime.title 
dateTextView.text - this.crime.date.toString() 
} 


override fun onClick(v: View) { 
Toast.makeText(context, "${crime.title} pressed!", Toast.LENGTH_SH 
. show() 


在 以 上 代码 中 ，CrimeHolder 类 实现 了 OnClickListener 接 口 ， 而 对 
于 itemView 来 说 ，CrimeHolder 承 担 了 接收 用 户 点 击 事 件 的 任务 。 


运行 CriminalIntent 应 用 。 点 击 某 个 列表 项 ， 可 看 到 弹出 的 Toast 啊 应 消 
He, 


99 深入 学 习 : ListView5GridView 


Android 操 作 系 统 核心 库 包 含 ListView、Gridview 和 Adapter 这 三 个 
Æ. Android 5.0 之 前 ， 创 建 列 表 项 或 网 格 项 都 应 该 优先 使 用 这 些 类 。 


erat ee ListView#llGridView 
不 关心 具体 的 展示 项 ， 只 负 贡 展示 项 的 滚动 。Adapter 负 责 创 建 列表 项 
的 所 有 视图 。 不 过 ， 使 用 ListView 和 Gridview 时 不 一 定 非 要 使 

用 ViewHolder 模 式 ( 昌 然 可 以 并 且 应 该 使 用 ) 。 


过 去 传统 的 实现 方式 现 已 被 RecyclerView 的 实现 方式 取代 ， 因 此 不 用 
再 费力 地 调整 ListView 和 GridView 的 工作 行为 了 。 


举例 来 说 ，ListView API 不 支持 创建 水 平 滚动 的 ListView， 因 此 需要 

许多 额外 的 定制 工作 。 使 用 RecyclerView 时 ， 虽 然 创建 定制 布局 和 演 

ccn MON 但 RecyclerView 天 生 文 持 拓 展 ， 所 以 使 用 
验 还 不 错 。 


此 外 ，RecyclerView 还 有 支持 列表 项 动画 效果 的 优点 。 如 果 让 
ListView 和 Gridview 文 持 添 加 和 删除 列表 项 的 动画 效果 ， 那 么 实现 起 
来 既 复 杂 又 容易 出 错 ; 而 对 于 天 生 支 持 动 画 特效 的 RecyclerView 来 


说 ， 对 付 这 些 任务 简直 是 小 六 一 碟 。 


例如 ， 如 果 crime 列 表 项 要 从 位 置 0 移动 到 位 置 5， 那 么 下 面 这 段 代 码 就 
可 以 做 到 。 


recyclerView.adapter.notifyItemMoved(0, 5) 


9.10 ”挑战 练习 : RecyclerView 的 ViewType 


请 在 RecyclerView 中 创建 两 类 列表 项 : 一 般 性 crime 和 需 警方 介入 的 

crime。 要 完成 这 个 挑战 ， 需 要 用 到 RecyclerView.Adapter 的 视图 类 
别 (view type) 功能 。 在 Crime 对 象 里 ， 再 添加 一 个 requiresPolice 
新 属性 ， 使 用 它 并 借助 getItemViewType(Int) 函 数 ， 确 定 该 加 载 哪个 
视图 到 CrimeAdapter。 


fEonCreateViewHolder(ViewGroup, Int)jZ5 B, JE T 
getItemViewType(Int) 函 数 返 回 的 viewType 值 ， 你 需要 添加 逻辑 返 
回 不 同 的 ViewHolder。 如 果 是 一 般 性 crime， 那 么 仍然 使 用 原始 布局 ; 
如 末 是 需 警 方 介入 的 crime， 则 使 用 一 个 有 “联系 警方 ”按钮 的 新 布局 。 


Ach ES 3» 

第 10 3€ 使 用 布局 与 部 件 创建 用 
F JB 

本 章 ， 我 们 来 给 RecyclerView 列 表 项 添加 一 些 样式 ， 借 此 学 习 更 多 有 
关 布 局 和 部 件 的 知识 。 同 时 ， 我 们 还 会 重点 学 习 使 用 一 个 叫 

作 ConstraintLayout 的 新 工具 。 至 本 章 结束 时 ，CrimeListFragment 
视图 会 有 明显 改观 ， 整 个 应 用 看 起 来 更 加 大 气 漂 亮 ， 如 图 10-1 所 示 。 
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图 10-1 美观 大 气 的 CriminalIntent 心 用 
前 几 章 ， 在 布置 部 件 时 ， 我 们 使 用 了 藤 套 布局 。 如 在 第 1 章 GeoQuiz 应 用 


的 layoutactivity_main.xml 布 局 文件 中 ， 用 一 个 LinearLayout 舱 套 了 另 
一 个 LinearLayout。 显 然 ， 这 样 的 布局 舱 套 代码 难以 阅读 和 维护 。 更 
糟 的 是 ， 骸 套 布局 还 会 影响 应 用 的 性 能 表现 ， 因 为 Android 操 作 系 统 要 
花 更 多 的 时 间 度 量 和 布置 视图 。 这 意味 着 ， 应 用 局 动 后 ， 用 户 要 等 一 会 
儿 才 能 看 到 视图 出 现在 屏幕 上 。 


ConstraintLayout 最 适合 用 来 设计 扁平 或 是 复杂 又 漂亮 的 非 租 套 布 
局 。 不 过 ， 在 深入 探索 ConstraintLayout 新 工具 之 前 ， 先 来 做 点 准备 
工作 。 你 需要 把 图 10-1 中 漂亮 的 手 钳 图 像 复 制 一 份 放 入 项 目 。 打 开 随 书 
文件 ， 找 到 并 打开 10_LayoutsAndWidgets/CriminalIntent/app/src/main/res 
目录 ， 把 各 个 版 本 的 ic_solved.png 复 制 到 项 目 对 应 的 drawable 目 录 里 。 
另外 ，Android Studio 没 有 自动 引入 的 话 ， 还 需要 手动 引入 项 目 依 赖 : 


implementation ‘androidx.constraintlayout: constraintlayout: 1.1.3’. 


10.1 初 识 ConstraintLayout 布 局 


可 以 不 使 用 嵌 套 布局 ， 而 使 用 ConstraintLayout 工 具 给 布局 添加 一 系 
列 约束 (constraint) 。 把 约束 想象 为 橡皮 筋 ， 它 会 同 中 间 拉 拢 分 系 两 头 
的 东西 。 例 如 ， 如 图 10-2 所 示 ， 从 ImageView 视 图 右边 到 其 父 视图 右边 
CConstraintLayout 上 自己 ) ， 你 可 以 添加 一 个 约束 。 这 个 约束 问 右 拉 


着 ImageView 视 图 。 


图 10-2 右边 添加 了 约束 的 ImageView 
你 也 可 以 创建 四 个 方向 上 的 约束 E. E A, F) 。 如 图 10-3 所 示 ， 


如 果 创 建 两 个 相反 方 回 的 约束 ， 它 们 会 均等 地 同 相 反 的 方 问 
拉 ，ImageView 视 图 就 会 处 于 正中 间 位 置 。 


图 10-3 ”两 边 都 有 约束 的 ImageView 


综 上 所 述 可 以 得 出 重点 : 想 要 在 ConstraintLayout 里 布置 视图 ， 不 用 
拖 来 拖 去 ， 给 它们 添加 上 约束 就 可 以 了 。 


位 置 摆 放 有 办 法 了 ， 那 如 何 控制 部 件 大 小 呢 ? 有 三 个 选择 : 让 部 件 自 己 
决定 (使 用 wrap_content) 、 手 动 调整 、 让 部 件 充满 约束 布局 。 


有 了 上 述 部 件 布置 方法 ， 只 需 一 个 ConstraintLayout， 就 可 以 布置 多 
个 布局 。 不 需要 骸 套 布局 了 。 接 下 来 ， 一 起 来 看 看 如 何 使 用 约束 布置 
list_item _crime 布 局 文件 。 


10.2 图形 布局 编辑 器 


目前 为 止 ， 布 局 都 是 以 手动 输入 XML 的 方式 创建 的 。 本 节 ， 我 们 开始 
fii Fd Android Studio 图 形 布局 工具 。 


打开 layout/list_item_crime.xml 布 局 文件 ， 然 后 选择 窗口 底部 的 Design 标 
签 页 ， 如 图 10-4 所 示 。 
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图 10-4 图 形 布局 工具 中 的 视图 


图 形 布局 工具 界面 的 中 间 区 域 是 布局 的 界面 预览 窗口 。 右 边 紧 换 的 是 是 
图 (blueprint) 视图 。 复 图 和 预览 视图 有 点 像 ， 但 它 能 显示 各 个 部 件 视 
图 的 轮廓 。 预 览 让 你 看 到 视图 长 什么 样 ， 而 从 蓝图 可 以 看 出 各 个 部 件 视 


图 的 大 小 比例 。 


图 形 布局 工具 界面 的 左边 是 部 件 面板 视图 ， 它 包含 了 所 有 你 可 能 用 到 的 
部 件 ， 按 类 别 组 织 。 左 下 是 部 件 树 ， 部 件 树 表明 部 件 是 如 何在 布局 中 组 
织 的 。 如 宋 看 不 到 部 件 面板 和 部 件 树 ， 请 点 击 预览 帘 口 的 左边 打开 。 


图 形 布 局 工具 界面 的 右边 是 属性 视图 (attribute view) 。 在 此 视图 中 ， 
你 可 以 查看 并 编辑 部 件 树 中 己 选 中 的 部 件 属性 。 


首先 我 们 转换 list_item_crime.xml 布 局 ， 改 用 ConstraintLayout。 如 图 
10-5 所 示 ， 在 部 件 树 窗 口中 ， 右 键 单 击 根 LinearLayout， 人 然后 选择 
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图 10-5 ”转换 根 视 图 为 ConstraintLayout 


如 图 10-6 所 示 ，Android Studio 会 弹出 一 个 窗口 ， 让 你 确认 如 何 转换 。 
list_item_crime.xml 是 个 简单 布局 文件 ， 不 需要 深度 优化 。 因 此 ， 接 受 默 
认 值 ， 点 击 OK 按 钮 确认 。 


e e Convert to ConstraintLayout 
This action will convert your layout into a ConstraintLayout, and attempt to set up constraints 


such that your layout looks the way it did before. You may need to go and adjust the constraints 
afterwards to ensure that it behaves correctly for different screen sizes. 


Flatten Layout Hierarchy 


When selected, this action will not just convert this layout to ConstraintLayout, it will 


recursively remove all other nested layouts in the hierarchy as well such that you end up 
with a single, flat layout. This is more efficient. 


[C] Include custom views 
Don't flatten layouts referenced by id from other files 


If a layout defines an android:id attribute which is looked up from Java code, flattening 
out this layout may result in code that no longer compiles. Normally this action won't 
include these layouts, but if you want to get to a completely flat hierarchy, you may 


want to enable removing these and then updating the code references as necessary 
afterwards. 


Cancel 
图 10-6 ”转换 默认 配置 


转换 需要 点 时 间 ， 耐 心 等 一 会 儿 。 如 图 10-7 所 示 ， 转 换 完 成 后 ， 我 们 就 
可 以 用 上 全 新 的 ConstraintLayout 布 局 了 。 
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图 10-7 使 用 ConstraintLayout 布 局 


(奇怪 ， 为 什么 在 部 件 树 界面 看 到 的 还 是 linearLayout? IEA, fH 
后 会 解释 。) 
如 图 10-8 所 示 ， 在 靠近 布局 预览 窗口 顶部 的 工具 栏 上 ， 可 以 看 到 一 些 约 
束 编 辑 选 项 。 下 面 看 一 下 它们 分 别 有 什 么 作用 。 
显示 全 部 约束 
| 清除 全 部 约束 


' 
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cle | 
猜测 约束 
图 10-8 ”约束 编辑 选项 
。 显示 全 部 约束 
显示 你 在 预览 和 蓝图 视图 里 创建 的 全 部 约束 。 这 个 控制 项 有 时 很 有 


用 ， 有 时 帮 倒 忙 。 如 果 你 有 大 量 的 约束 ， 点 击 这 个 控制 按钮 ， 估 计 
你 会 得 密集 恐惧 症 。 


View Options 还 有 一 些 其 他 控制 选项 ， 比 如 Show Layout 
Decorations。 选 择 它 ， 会 看 到 应 用 运行 时 的 工具 栏 〈 详 见 第 14 章 ) 
和 一 些 其 他 系统 UI〈 比 如 状态 栏 ) 。 


目 动 连接 切换 开关 


启用 后 ， 在 预览 界面 拖 移 视图 时 ， 约 束 会 自动 配置 。Android Studio 
会 猜测 你 的 视图 布置 意图 ， 帮 你 上 自动 连接 。 


。 清除 全 部 约束 


清除 布局 文件 中 的 全 部 约束 。 稍 后 会 使 用 。 


。 推断 约束 


这 个 选项 类 似 自 动 连接 ，Android Studio 会 自动 帮 你 创建 约束 ， 但 需 
点 击 该 按钮 手动 触发 ， 而 目 动 连接 是 只 要 你 同 布 局 文件 添加 视图 就 
会 被 激活 。 


10.3 ”使 用 ConstraintLayout 


转换 list_item_crime.xml 使 用 ConstraintLayout 时 ， 根 据 原 布局 的 视图 
布置 ，Android Studio 已 经 自动 添加 了 约束 。 不 过 ， 为 了 观察 学 习 ， 我 们 
得 从 头 开 始 。 


在 部 件 树 里 选择 标 着 1inearLayout 的 最 顶层 视图 。 为 什么 还 

是 1inearLayout， 不 是 已 经 转换 为 ConstraintLayout 了 四 ? 实际 
上 ， 这 是 ConstraintLayout 转 换 器 提供 的 ID。 这 里 ，1inearLayout 
实际 耽 是 ConstraintLayout。 如 果 不 相 信 ， 可 以 打开 布局 XML 文件 确 
认 。 


在 部 件 树 里 选中 linearLayout， 然 后 选择 图 10-8 里 的 “清除 全 部 约 
束 ” 选 项 。 你 会 立即 看 到 警告 标志 ， 如 图 10-9 所 示 ， 点 击 它 看 看 究 竞 怎 
么 回 事 。 


2 Warnings 2 Errors X 
Message Source 
() Missing Constraints in ConstraintLayout crime title <TextView> 
This view is not constrained, It only has designtime positions, so it will jump to (0,0) at runtime unless you add the constraints 
The layout editor allows you to place widgets anywhere on the canvas, and it records the current position with designtime attributes (such as 
layout editor absoluteX). These attributes are not applied at runtime, so if you push your layout on a device, the widgets may appear in à 


different location than shown in the editor. To fix this, make sure a widget has both horizontal and vertical constraints by dragging from the 
edge connections, 


Issue id: MissingConstraints 


Q Missing Constraints in ConstraintLayout crime date <TextView> 
A Hardcoded text crime title <TextView> 
A Hardeoded text crime date «TextView» 


图 10-9 ConstraintLayout 4/4; 


原来 ， 视 图 没有 足够 的 约束 ，ConstraintLayout 不 知道 该 如 何 布局 
了 。TextView 部 件 根本 没有 约束 ， 因 此 它们 都 收 到 警告 说 ， 运 行 时 可 
能 不 能 出 现在 正确 位 置 。 


稍 后 ， 我 们 会 添加 需要 的 约束 来 修正 这 个 问题 。 在 添加 过 程 中 ， 注 意 查 
看 是 否 有 警告 信息 ， 以 避免 运行 时 的 异常 行为 。 

10.3.1 腾 出 空间 

两 个 TextView 部 件 占据 了 整个 区 域 ， 再 难 容 下 其 他 部 件 。 现 在 ， 需 要 
把 它们 缩小 。 


在 部 件 树 里 ， 选 中 crime_title， 人 然后 碍 看 右边 的 属性 视图 窗口 ， 如 图 
10-10 所 未 。 如 果 对 应 的 属性 面板 没 打 开 ， 请 点 击 右边 的 属性 页 打开 


Kio 


Attributes Q 
ID crime_title 
layout_width 411dp 


layout_height 


wrap_content 


图 10-10 ”TextView 的 属性 


TextView 水 平方 向 和 竖 直 方 同 的 尺寸 分 别 由 宽度 设置 和 高 度 设 置 决 
能 设置 的 值 有 以 下 三 种 ， 如 图 10-11 所 示 。 每 种 值 都 对 应 
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KE o 
layout_width 或 layout_height 的 一 个 值 。 


Bek as 


layout width $84dp Glia layout width wrap_content Y^ 
layout height 100dp it layout height Wrap. content v 
0 
OHHH 


layout, width 


layout, height 


JEN 


match constraint 


match constraint 
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图 10-11 三 种 视图 尺寸 设置 
表 10-1 列 举 了 视图 尺寸 设置 类 型 及 其 设置 值 和 用 法 。 


表 10-1 视图 尺寸 设置 类 型 


设置 什 
7 以 dp 为 单位 ， 为 视图 指定 固定 值 Cdp 稍 后 介绍 ) 。 
: 太 清 楚 dp 单位 的 概念 ， 请 参看 2.6 节 


设置 视图 想 要 的 尺寸 〈 随 内 容 走 ) ， 也 就 是 说 ， 大 到 足够 
wrap_content des pe 
容纳 内 容 


match constraint | 允许 视图 缩放 以 满足 指定 约束 


"AH, crime _ title 和 crime_date 都 设 定 了 一 个 最 大 的 固定 宽度 值 ， 
所 以 占据 了 整个 屏幕 。 选 中 crime title， 把 宽度 值 设 

为 wrap_content， 如 条 有 必要 ， 把 高 度 值 也 设 为 wrap_content， 如 图 
10-12 所 示 。 


Attributes Q 2 x — 


ID crime title 
layout width wrap content | ss 
layout height wrap. content Y 
© 
©- > : «eO 
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图 10-12 ”调整 crime title 的 宽 高 值 
重复 上 述 步骤 ， 设 置 crime_date 的 宽 高 值 。 


如 图 10-13 所 示 ， 现 在 这 两 个 部 件 小 一 些 了 。 不 过 ， 因 为 没 加 约束 ， 当 
应 用 运行 时 ， 会 看 到 它们 还 重 县 在 一 起 了 。 注 意 ， 在 预览 界面 和 在 应 用 
运行 时 看 到 的 部 件 位 置 是 不 一 样 的 。 因 为 在 预览 界面 ， 部 件 位 置 摆 放 要 
ae 添加 约束 。 部 件 在 应 用 运行 时 的 位 置 才 是 真实 


人 ，N，0pkely x287 O AppThemer Q) Default (en-us) v Qe 9 0 
Ov Yb, i Pin 


Crime Title 


Crime Date 


图 10-13 ”改正 属性 后 的 TextView 


稍 后 ， 我 们 会 给 TextView 部 件 添加 正确 的 约束 。 现 在 ， 先 来 添加 布局 里 
需要 的 其 他 部 件 。 


10.3.2 ”添加 部 件 


处 理 完 两 个 TextView， 可 以 问 布 局 文件 里 添加 手 钳 图 片 了 。 前 先 添加 
一 个 ImageView 视 图 。 如 图 10-14 所 示 ， 在 部 件 面板 里 找到 ImageView 
部 件 ， 把 它 拖 入 部 件 树 ， 并 作为 ConstraintLayout 的 子 部 件 ， 放 
fEcrime date Fil. 


Palette Q $ 一 


Common Ab TextView 
Text 8&8 Button 

网 ImageView 
Buttons 


:三 RecyclerView 
<> <fragment> 
Layouts BI ScrollView 


Widgets 


Containers | *9 Switch 
Google 


Legacy 


图 10-14 ”找到 ImageView 部 件 


在 随后 弹出 的 对 话 框 里 ， 选 择 ic_solved 作 为 ImageView 部 件 的 资源 ， 
如 图 10-15 所 示 。 这 个 图 片 用 来 表明 crime 己 经 解决 。 


000 Resources 


Q Add new resource ¥ 
> Sample data cee 
MA B Name: ic solved whdp v 
Color = 
Bleue Mo TA PNG 
Dib rte patra EF WA m 
enn ds m SA 
S " Ny " " i nd Pian 
“y Jauncher foreground | ae, 
(nee rn 
A i Solved 
[dd 
> android ， 
? Theme attributes 


@drawable/ic_solved 
= i¢_solved. png 


<= 
图 10-15 ”选择 ImageView 部 件 资 源 


ImageView 部 件 添加 完了 ， 但 它 还 没有 任何 约束 。 虽 然 它 现在 有 个 位 
置 ， 但 这 个 位 置 没 有 任何 意义 。 


现在 为 它 添 加 约束 。 在 部 件 树 或 者 预览 界面 里 选中 ImageView 部 件 。 


《如 果 想 看 的 清楚 些 ， 可 以 放大 预览 界面 。 缩 放 控制 在 约束 工具 上 面 的 
工具 栏 内 。) 可 看 到 ImageView 的 四 边 都 有 圆 点 ， 如 图 10-16 所 示 ， 这 
些 点 表示 约束 柄 。 


图 10-16 ”ImageView 部 件 的 约束 柄 


按照 设计 构想 ，ImageView 部 件 要 放 在 视图 的 右边 。 这 需要 给 
ImageView 部 件 的 上 、 下 和 右 三 条 边 添加 约束 。 


如 图 10-17 所 示 ， 添 加 约束 之 前 ， 辣 右 拖 动 ImageView 部 件 ， 离 两 个 
TextView 远 一 点 儿 。 不 要 担心 暂时 的 摆 放 位 置 ， 等 添加 好 所 有 约束 ， 位 
置 自 然 就 正确 了 。 
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Crime Title 
Crime Date 


图 10-17 和 暂时 移动 一 个 部 件 


首先 来 设置 ImageView 部 件 顶部 和 ConstraintLayout 部 件 顶 部 之 间 的 
约束 。 在 预览 界面 ， 拖 住 ImageView 部 件 顶 部 的 约束 柄 ， 将 其 拖 

向 ConstraintLayout 部 件 顶 部 。 如 图 10-18 所 示 ， 约 束 柄 会 显示 为 一 个 
入 各、 

BK o 


—— 
rime Title 
rime Date 


图 10-18 ”开始 创建 顶部 约束 
继续 向 上 拖 ， 直 到 约束 柄 变 赣 ， 再 松 开 鼠标 创建 顶部 约束 ， 如 图 10-19 


所 示 。 
rime Title 
rime Date AA 


图 10-19 创建 顶部 约束 


注意 ， 光 标 变 为 扔 角形 状 时 ， 不 要 点 击 ， 因 为 这 会 改变 ImageView 部 件 
的 尺寸 。 男 外 ， 还 要 小 心 别 把 约束 设 到 TextView 部 件 上 。 如 果真 的 搞 
错 了 ， 就 点 击 约束 柄 删 掉 后 重 做 。 


松 开 鼠标 设置 约束 时 ， 视 图 会 立即 就 位 以 表明 现在 有 了 一 个 新 约束 。 这 
就 是 视图 在 ConstraintLayout 里 摆 放 的 方式 一 一 设置 和 删除 约束 。 


想 确 认 ImageView 顶 部 和 ConstraintLayout 顶 部 是 不 是 已 经 连接 了 约 
束 ， 可 在 ImageVview 悬 停 鼠 标 ， 如 果 是 ， 应 该 会 出 现 如 图 10-20 所 示 的 
形状 。 


Se ^ 


图 10-20 RAR A ImageView 


按 同样 的 方式 ， 拖 住 ImageView 部 件 底 部 的 约束 柄 ， 拖 到 根 视 图 的 底 
部 。 同 样 ， 不 要 拖 到 TextView 上 ， 如 图 10-21 所 示 。 


e 
rime Title 
rime Date 
© 
图 10-21 和 带 顶 部 和 底部 约束 的 ImageView 
最 后 ， 向 根 视图 右边 拖 忠 ImageView 的 右 约束 柄 ， 设 置 右 边 约束 。 完 成 


后 ， 将 鼠标 悬 停 在 ImageView 部 件 上 ， 确 认 所 有 的 约束 都 已 正确 设置 ， 
如 图 10-22 所 示 。 


Crime Title Yo 
Crime Date 
图 10-22 ” ImageView 上 设置 了 三 个 约束 


10.3.3 ”约束 的 工作 原理 


最 终 ， 图 形 布局 编辑 器 窗口 的 任何 编辑 都 会 体现 在 XML 文 件 里 。 妆 
然 ， 如 果 你 愿意 ， 也 可 以 直接 编辑 原生 ConstraintLayout XML。 不 
过 ， 显 然 还 是 使 用 图 形 布局 编辑 器 设置 初始 约束 更 容 


易 。ConstraintLayout 比 其 他 ViewGroup 部 件 更 为 复杂 ， 手 动 添加 初 
始 约束 工作 量 很 大 。 在 XML 文件 里 做 一 些 布 局 小 改动 更 合适 。 


《图形 布局 编辑 器 很 有 用 ， 尤 其 是 在 使 用 ConstraintLayout 布 置 部 件 
时 。 当 然 ， 并 不 是 每 个 人 都 喜欢 用 这 种 编辑 堪 。 你 不 需要 选 边 站 ， 可 以 
在 图 形 化 和 XML 编辑 之 间 随 时 切换 ， 怎 么 方便 怎么 来 。) 


将 布局 切换 到 XML 文件 模式 。 看 看 刚 为 ImageView 创 建 的 三 个 约束 都 回 
XML 文件 里 添加 了 什么 内 容 。 


«androidx.constraintlayout.widget.ConstraintLayout 
e» 


«ImageView 
android: id="@+id/imageView" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:layout marginTop-"8dp" 
android:layout marginEnd-"8dp" 
android:layout marginBottom-"8dp" 
app:layout constraintBottom toBottomOf-"parent" 
app:layout constraintEnd toEndOf-"parent" 
app:layout constraintTop toTopOf-"parent" 
app:srcCompat="@drawable/ic_solved" /> 


«/android.support.constraint.ConstraintLayout» 


《两 个 TextView 定 义 还 是 有 错误 提示 。 和 暂时 忽略 ， 稍 后 再 来 修正 它 
(eee, 
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以 顶部 约束 为 例 ， 我 们 来 看 一 下 它 的 属性 设置 : 

这 个 属性 以 layout_ 开头 。 凡 是 以 layout_ 开 头 的 属性 都 属于 布局 参数 


(layout parameter) 。 与 其 他 属性 不 同 的 是 ， 部 件 的 布局 参数 是 用 来 问 
其 父 部 件 做 指示 的 ， 即 用 于 告诉 父 布局 如 何 安 排 自 己 。 目 前 为 止 ， 我 们 


己 经 见识 过 好 几 个 这 样 的 布局 参数 ， 比 如 layout_width 和 
layout_height. 


约束 的 名 字 是 constraintTop。 这 表示 它 是 ImageView 的 顶部 约束 。 


最 后 ， 属 性 以 toTopof="parent" 结 束 ， 这 表明 ， 约 束 是 连接 到 父 部 件 
(ConstraintLayout)〉 顶 部 的 。 

好 了 ， 一 口气 做 了 这 么 多 ， 该 向 一 欣 了。 不 过 ， 事 情 还 没完 ， 我 们 回 到 
图 形 布局 编辑 器 窗口 。 


10.3.4 ”编辑 属性 
现在 ，ImageView 部 件 的 位 置 已 经 摆 正 确 了 。 接 下 来 的 任务 是 布置 和 调 


整 标题 TextView 部 件 。 


首先 ， 在 部 件 树 里 选中 crime_date， 把 它 拖 忠 到 别处 ， 如 图 10-23 所 
示 。 注 意 ， 在 预览 界面 ， 拖 到 别处 看 上 去 是 换 了 人 位置， 但 应 用 运行 时 ， 
你 依然 看 不 到 这 种 位 置 变化 。 应 用 运行 时 ， 只 有 约束 起 作用 。 


Crime Title 


rime Date 
图 10-23 ”把 crime_date 拖 到 别处 


现在 ， 在 部 件 树 里 选中 crime title 视图 。 这 也 会 让 预览 界面 的 
crime _ title 部 件 处 于 加 亮 状态 。 它 的 目标 位 置 是 布局 的 左上 
角 ，ImageView 部 件 的 左边 。 这 需要 添加 以 下 三 个 约束 : 


e 从 crime_title 视 图 的 左边 到 其 父 部 件 的 左边 ; 
e 从 crime_title 视 图 的 顶部 到 其 父 部 件 的 顶部 ; 
e 从 crime_title 视 图 的 右边 到 ImageView 部 件 的 左边 。 


创建 上 述 约束 。 定 位 、 拖 上 忠 需 要 耐心 和 技巧 ， 不 行 就 多 用 
Command+Z〔 或 Ctrl+Z) 撤销 快捷 键 反 复试 几 次 。 确 认 约 束 都 添加 完 


成 ， 如 图 10-24 所 示 。 


Crime Title 


Qo 


Crime Date 


图 10-24 TextView 视 图 的 约束 


现在 ， 我 们 要 给 TextView 上 的 约束 添加 边 距 值 。 在 预览 界面 ， 选 中 
crime_title 部 件 ， 查 看 右边 的 属性 面板 。 上 既然 已 经 给 TextView 添 加 
了 顶部 、 左 边 和 右边 约束 ， 就 能 为 它们 从 下 拉 菜 单 选择 边 距 值 。 如 图 
10-25 所 示 ， 左 边 距 和 顶部 边 距 设 置 值 为 16dp， 右 边 距 设置 值 为 8dp。 


Attributes Q lg — 
ID crime_title 
layout_width wrap_content v 
layout_height wrap_content v 

16 |v 


图 10-25 ”给 TextView 设 置 边 距 


对 于 边 距 值 ，Android Studio 默 认 会 选 16dp 或 8dp。 这 种 默认 值 设 置 遵 循 
Android 的 material design 原 则 . 


确认 crime_title 的 约束 设置 如 图 10-26 所 示 。 如果 选中 部 件 的 约束 
被 拉 长 ， 则 都 会 显示 为 细密 的 波 泥 线 。) 


Ro 


Crime Date 
图 10-26 crime _ title 视图 的 约束 


fixe f crime title 的 约束 ， 现 在 设置 视图 尺寸 。 视 图 水 平 宽 度 设 置 为 
动态 适应 (match constraint) ， 这 样 标题 文 字 束 可 以 占 满 约束 之 间 
的 空间 了 。 视 图 垂直 高 度 设置 为 包 早 内容 (wrap content) ， 以 便 刚 
好 显示 出 crime 标 题 。 最 后 ， 确 认 设 置 结果 如 图 10-27 所 示 。 


Attributes Qo €x — 
ID crime title 
layout. width match. constraint | v 
layout height wrap. content v 
16 |v 
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图 10-27 crime _ title 视图 设置 


接 下 来 处 理 crime_date 视 图 。 在 部 件 树 里 选中 它 ， 参 照 crime_ title 
约束 添加 步骤 ， 为 其 添加 以 下 三 个 约束 : 


e 从 crime_date 视 图 的 左边 到 其 父 部 件 的 左边 ， 带 16dp 的 边 距 ; 


e 从 crime_date 视 图 的 顶部 到 crime_title 视 图 的 底部 ， 


带 8dp 的 边 


JB; 
e 从 crime_date 视 图 的 右边 到 ImageView 部 件 的 左边 ， 带 8dp 的 边 
JB. 
完成 约束 设置 后 ， 设置 视图 尺寸 。 和 crime_title 视 图 一 样 ， 设 置 
视图 宽度 为 动态 适应 (match constraint) ， 高 度 为 包 庄内 容 
p 最 后 ， 确 认 设 置 结果 如 图 10-28 所 示 。 
Attributes Q l&k — 
ID crime_date 
layout_width match_constrain | v 
layout_height wrap_content v 
8 v 
16 |v C | 8 v 
© 


图 10-28 crime _date 视 图 设置 


现在 ， 碍 看 预览 ， 应 该 能 看 到 类 似 图 10-1 的 显示 效果 。 近 看 ， 预 览 界 面 


应 该 和 图 10-29 一 样 。 


Crime Title 


Crime Date 


图 10-29 ”约束 设置 完成 的 近 观 图 


2o 


从 布局 预览 界面 切换 到 XML 代码 界面 ， 碍 看 我 们 在 图 形 化 布局 编辑 器 
中 所 做 的 设置 结果 。TextView 定 义 处 的 红色 下 划 线 消失 了 。 这 是 因 
为 TextView 部 件 现 在 已 被 约束 好 了 。 应 用 运行 时 ， 包 含 它 们 的 
ConstraintLayout 知 道 该 怎样 正确 摆 放 它们 了 。 


不 过 ， 与 TextView 相 关 的 两 处 黄色 警告 依然 存在 。 仔 细 观 察 会 发 现 ， 
警告 和 它们 的 人 硬 编码 文字 有 关 。 对 生产 级 应 用 来 说 ， 这 样 的 警告 应 该 重 
视 。 而 对 CriminalIntent 应 用 来 说 ， 可 以 忽略 不 管 。〔 想 管 也 可 以 ， 按 照 
建议 把 硬 编码 拆 成 字符 串 资 源 就 能 解决 问题 。) 


另外 ，ImageVview 部 件 定义 处 也 有 一 处 警告 提示 你 筷 记 为 它 设 置 内 容 描 
述 了 。 现 在 ， 还 是 忽略 掉 好 了 。 第 18 章 会 解决 这 个 问题 。 当 然 ， 应 用 功 
能 现在 没 啥 问 题 。 不 过 ， 使 用 屏 幕 阅读 功能 的 人 《视力 障碍 用 户 ) iti 
法 知道 照片 是 什么 内 容 了 。 


运行 CriminalIntent 心 用 ， 硝 认 三 个 部 件 在 RecyclerView 视 图 中 都 显示 
得 上 下 齐整 、 玖 落 有 致 ， 如 图 10-30 所 示 。 


9:00 | 


CriminallIntent 


Crime #0 
Tue Dec 18 14:39:48 EST 2018 


Crime #1 
Tue Dec 18 14:39:48 EST 2018 


Crime #2 
Tue Dec 18 14:39:48 EST 2018 


Crime #3 
Tue Dec 18 14:39:48 EST 2018 


Crime #4 
Tue Dec 18 14:39:48 EST 2018 


Crime #5 
Tue Dec 18 14:39:48 EST 2018 


Crime #6 
Tue Dec 18 14:39:48 EST 2018 


Crime #7 
Tue Dec 18 14:39:48 EST 2018 


Crime #8 
Tue Dec 18 14:39:48 EST 2018 


Crime #9 四 


图 10-30 每 行 三 个 视图 
10.35 ”动态 设置 列表 项 


当前 ， 应 用 运行 时 ， 每 行 都 显示 了 手 钳 图片。 这 和 实际 不 符 ， 需 要 修 
改 ImageView 部 件 解 决 。 


首先 ， 更 新 ImageView 部 件 的 ID (部件 添 加 时 已 设置 了 默认 名 ) 。 在 部 
件 树 里 选中 它 ， 然 后 在 视图 属性 窗口 将 ID 修改 为 crime_solved， 如 图 10- 
31 所 示 。Android Studio 会 询问 是 否 更 新 所 有 用 到 该 ID 的 地 方 ， 点 击 Yes 
按钮 确认 。 


PPPPPPPPP 


Attributes Q lg — 


ID crime_solved| 
layout_width wrap_content v 
layout_height wrap_content Y 


图 10-31 更 新 ImageView 部 件 的 ID 


你 可 能 注意 到 了 ， 在 list_item_crime.xml 和 fragment_crime.xml 布 局 里 ， 
都 用 了 crime_solved 这 一 ID。 这 样 会 不 会 有 问题 呢 ? 别 担心 ， 这 么 做 没 
问题 。 只 有 在 同一 布局 里 ， 系 统 才 会 要 求 所 有 部 件 都 使 用 唯一 ID。 


更 新 完 ID， 代 码 也 要 做 对 应 和 更新。 打开 CrimeListFragment.kt 文 件 ， 
在 CrimeHolder 类 中 ， 添 加 一 个 ImageView 实 例 变量 。 然 后 ， 根 
据 crime 记 录 的 解决 状态 控制 图 片 的 显示 ， 如 代码 清单 10-1 所 示 。 


代码 清单 10-1 ”控制 手 钳 图 片 显示 CCrimeListFragment.kt 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view), View.OnClickListener { 


private val dateTextView: TextView 
private val solvedImageView: ImageView = itemView.findViewById(R.id. 


init { 


} 


fun bind(crime: Crime) { 
this.crime = crime 
titleTextView.text = this.crime.title 
dateTextView.text = this.crime.date.toString() 
solvedImageView.visibility = if (crime.isSolved) { 
View. VISIBLE 
} else { 
View. GONE 


运行 CriminalIntent 应 用 ， 确 认 手 钱 图 片 能 按 问 题解 决 情 况 正确 显示 。 


10.4 深入 学 习 布 局 属性 


本 节 ， 我 们 再 来 微调 一 下 list_item_crime.xml 布 局 设计 ， 同 时 解答 一 些 可 
能 令 人 困扰 的 部 件 与 属性 相关 问题 。 


回 到 list_item_crime.xml 布 局 图 形 设计 界面 。 选 中 crime_title， 在 属性 
视图 窗口 ， 我 们 来 调整 一 些 必 性。 点 击 textAppearance 劳 边 的 箭头 ， 展 
示 部 件 的 各 种 文字 和 字体 属性 。 修 改 textSize 属 性 值 为 188p， 修 改 
textColor 属 性 值 为 @android:color/black， 如 图 10-32 所 示 。 


Attributes Q elg — 
Bessa 
© 

TextView 
text Crime Title 
# text 
contentDescription 

textAppearance Material v 
fontFamily sans-serif v 
typeface none v 
textSize | 18sp| |» Z 
lineSpacingExtra none > 


textColor 


Bl @android:color/black 


textStyle B I Tr 


textAlignment EB 三 三 三 = 


Favorite Attributes 
图 10-32 a pC KAD A ES 


有 多 种 方式 可 以 调整 属性 值 。 例如， 在 属性 面板 直接 输入 属性 值 、 从 下 
拉 列 表 选 值 ， 或 者 点 击 带 三 个 小 点 的 按钮 选择 资源 。 


运行 CriminalIntent 应 用 。 可 以 看 到 ， 整 个 应 用 界面 的 显示 效果 非常 好 ， 
像 是 新 刷 了 漆 ， 如 图 10-33 所 示 。 


9:00 Vues 


Criminallntent 


Crime #0 Qo 


Tue Dec 18 16:43:18 EST 2018 


Crime #1 
Tue Dec 18 16:43:18 EST 2018 


Crime #2 Po 


Tue Dec 18 16:43:18 EST 2018 


Crime #3 
ue Dec 18 16:43:18 EST 2018 


Crime #4 Qo 


Tue Dec 18 16:43:18 EST 2018 


Crime #5 
Tue Dec 18 16:43:18 EST 2018 


Crime #6 Qo 


Tue Dec 18 16:43:18 EST 2018 


Tue Dec 18 16:43:18 EST 2018 


Tue Dec 18 16:43:18 EST 2018 


图 10-33 3r my 


样式 〈style) 是 XML 资源 文件 ， 含 有 用 来 描述 部 件 行为 和 外 观 的 属性 定 
义 。 例 如 ， 使 用 下 列 样式 配置 部 件 ， 就 能 显示 比 正 常 大 小 更 大 的 文字 : 


<style name="BigTextStyle"> 
<item name="android:textSize">2@sp</item> 


<item name="android: padding" >3dp</item> 
</style> 


你 可 以 创建 自己 的 样式 文件 〈 参 见 第 21 章 ) 。 具 体 做 法 是 将 属性 定义 添 
加 并 保存 在 res/values/ 目 录 下 的 样式 文件 中 ， 然 后 在 布局 文件 中 以 
@style/my_own_style《〈 样 式 文件 名 ) 的 形式 引用 。 


再 来 看 看 layout/fragment_crime.xml〈 别 搞 错 ， 不 是 list_item_crime.xml) 
文件 中 的 两 个 TextView 部 件 。 每 个 部 件 都 有 一 个 引用 Android 自 禹 样式 
文件 的 style 属 性 。 该 预定 义 样 式 来 自 应 用 的 主题 ， 能 让 屏幕 上 的 
TextView 部 件 看 起 来 是 以 列表 样式 分 隅 开 的 。 主 题 是 各 种 样式 的 集 
合 。 从 结构 上 来 说 ， 主 题 本 映 也 是 一 种 样式 资源 ， 只 不 过 它 的 属性 指 问 
了 其 他 样式 资源 。 


Android 自 带 了 一 些 供应 用 使 用 的 平台 主题 。 例 如 ， 在 创建 
CriminalIntent 应 用 时 ， 问 导 束 设置 了 默认 主题 (是 在 manifest 文 件 的 
app1ication 标 签 下 引用 的 ) 。 


使 用 主题 属性 引用 ， 可 将 预定 义 的 应 用 主题 样式 添加 给 指定 部 件 。 在 
fragment_crime.xml 文 件 中 ， 样 式 属性 值 ? 
android:1istseparatorTextViewSty1le 的 使 用 就 是 这 样 一 个 例子 。 


使 用 主题 属性 引用 ， 就 是 告诉 Android 运 行 资源 管理 器 : “在 应 用 主题 里 
找到 名 为 listseparatorTextViewSstyle 的 属性 。 该 属性 指向 其 他 样 
式 资源 ， 请 将 其 资源 值 放 在 这 里 。” 


所 有 Android 主 题 都 包括 名 为 1istSeparatorTextViewSty1le 的 属性 。 
不 过 ， 基 于 特定 主题 的 整体 风格 ， 它 们 的 定义 稍 有 不 同 。 使 用 主题 属性 
引用 ， 可 以 确保 TextView 部 件 在 应 用 中 拥有 正确 一 致 的 显示 风格 。 


你 还 会 在 第 21 章 学 习 到 更 多 有 关 样 式 及 主题 的 使 用 知识 。 


10.5 深入 学 习 : WE- W E 


在 GeoQuiz 和 CriminalIntent 这 两 个 应 用 中 ， 我 们 给 部 件 设置 过 边 距 
(margin) 与 内 边 距 (padding) 属性 。 开 发 新 手 有 时 分 不 清 这 两 个 属 
性 。 既 然 你 已 明白 什么 是 布局 参数 ， 那 么 二 者 的 区 别 也 就 显而易见 了 。 


边 距 属性 是 布局 参数 ， 决 定 了 部 件 间 的 距离 。 由 于 部 件 对 外 界 一 无 所 
知 ， 因 此 边 距 必须 由 该 部 件 的 父 部 件 负责。 


内 边 距 不 是 布局 参数 。 属 性 android:padding 告 诉 部 件 ， 在 绘制 部 件 
自身 时 ， 要 比 所 含 内 容 大 多 少 。 举 例 说 明 : 在 不 改变 文字 大 小 的 情况 
下 ， 想 把 日 期 按钮 变 大 一 些 ， 如 图 10-34 所 示 。 


TITLE 
Enter a title for the crime. 


DETAILS 


WED NOV 14 11:56 EST 2018 


Q Solved 


Asp tors ers et RE ty 


图 10-34 把 日 期 按钮 变 大 
可 将 下 面 的 属性 添加 给 Button: 


<Button 
android: id="@+id/crime_date" 
android: layout_width="match_parent" 


android: layout_height="wrap_content" 
android: padding="8@dp" 
tools:text="Wed Nov 14 11:56 EST 2018"/> 


大 按钮 很 方便 ， 但 很 可 惜 ， 继 续 学 习 前 ， 还 是 应 该 删除 这 个 属性 。 


10.6 深入 学 习 : ConstraintLayout 的 发 展 动态 


ConstraintLayout 本 领 很 多 ， 能 协助 我 们 布置 子 视 图 。 本 章 ， 通 过 
在 TextView、ImageView 和 它们 的 父 视图 、 相 令 视 图 之 间 设 置 约束 关 
系 ， 我 们 正确 摆 放 了 它们 的 位 置 。ConstraintLayout 还 有 Guideline 
这 样 的 帮助 视图 可 用 ， 可 以 更 好 地 帮 你 在 屏幕 上 布置 视图 部 件 。 


Guideline 帮 助 视 图 不 会 出 现在 应 用 屏幕 上 ， 它 们 的 作用 仅 限 于 帮助 布 
置 视图 。Guideline 还 有 水 平和 竖 直 类 型 之 分 。 按 照 dp 值 或 屏幕 比例 
值 ， 你 可 以 把 它们 放 在 特定 的 位 置 上 ， 让 其 他 视图 和 它们 之 间 保 持 某 种 
约束 关系 ， 即 使 屏 间 尺寸 有 变化 也 能 保持 定位 准确 。 


图 10-35 是 一 个 紧 直 Guideline 的 使 用 示例 。 它 现在 处 于 20% 父 视图 宽度 
Whi. crime date 和 crime _ title 视图 和 它 之 间 都 有 一 个 约束 关 
系 。 


@ 


«Crime Title 


20 96 ime Date 


图 10-35 ”使 用 Guideline 


MotionLayout 是 ConstraintLayout 的 一 个 扩展 。 有 了 它 ， 向 视图 添 
加 动画 就 容易 多 了 。 为 了 使 用 MotionLayout， 你 可 以 创建 一 个 
MotionScene 文 件 ， 约 定 如 何 执 行动 画 ， 以 及 在 开始 和 结束 布局 里 各 个 
视图 的 映射 关系 是 什么 。 你 也 可 以 设置 keyframe 作 为 动画 过 程 中 的 中 
间 视 图 。 然 后 ，MotionLayout 开 始 执行 动画 ， 从 启动 视图 开始 ， 经 过 
keyframe， 直 到 视图 动画 正确 播放 至 结束 视图 。 


10.7 挑战 练习 : 日 期 格式 化 


与 其 说 Date 对 象 是 普通 日 期 ， 不 如 说 是 时 间 惟 。 调 用 Date 对 象 的 
tostring() 函 数 ， 怠 能 得 到 一 个 时 间 惟 。RecyclerView 视 图 上 显示 的 
了 驶 是 一 个 时 间 惟 。 时 间 惟 虽然 凑合 能 用 ， 但 如 果 能 显示 人 们 习惯 看 到 的 
日 期 应 该 会 更 好 ， 比 如 “Jul 22, 2019”。 要 实现 此 目标 ， 可 使 

用 android.text.format.DateFormat 类 实例 。 具 体 怎 么 用 ， 请 查阅 
Android 文 档 库 中 有 关 该 类 的 说 明 。 


使 用 DateFormat 类 中 的 函数 ， 可 获得 常见 格式 的 日 期 ， 也 可 以 自己 定 
制 字 符 串 格式 。 最 后 ， 再 来 一 个 更 有 挑战 的 练习 : 创建 一 个 包含 星期 的 
字符 串 格 式 ， 比 如 “Monday, Jul 22, 2019". 


"Bl 数据 库 与 Room 亩 


几乎 所 有 应 用 都 有 持久 化 保存 数据 的 需要 。 本 章 ， 我 们 将 首先 为 
CriminalIntent 应 用 创建 一 个 数据 库 并 使 用 种 子 数据 进行 填充 。 然 后 ， 更 
新 应 用 从 数据 库 读 取 数 据 并 显示 在 crime 列 表 项 中 ， 如 图 11-1 所 示 。 
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Criminallntent 


unprofessional dishes in storage room Qo 
Fri May 10 14:54:30 EDT 2019 


toxic lunch in copy room 
Fri May 10 14:54:39 EDT 2019 


messy sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


unproductive sink in copy room 
Fri May 10 14:54:54 EDT 2019 


dirty sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board at reception Qo 
Fri May 10 14:54:54 EDT 2019 


u 
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productive shoes in copy room Qo 
Fri May 10 14:54:54 EDT 2019 


unproductive garbage can in storage room Qo 
Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board in bathroom 


Fri B 10 14:54:54 EDT 2019 


图 11-1 来 自 数 据 库 的 crimes 数 据 


在 第 4 章 中 ， 为 应 对 设备 旋转 和 进程 销毁 ， 你 已 学 会 使 用 ViewMode1 和 
保留 实例 状态 来 保存 UI 状态 数据 。 这 两 种 方式 非常 适合 与 UI 相关 的 少量 
数据 的 保存 。 不 过 ， 对 于 那些 非 UI 数 据 ， 或 者 虽然 与 UI 状态 相关 ， 但 不 
和 activity 或 fragment 绑 定 的 数据 ， 就 需要 寻求 不 同 的 数据 保存 办 法 了 。 


一 般 来 讲 ， 非 UI 相关 数据 要 么 保存 在 本 地 (本 地 文件 系统 ， 或 者 是 稍 后 
就 要 为 CriminalIntent 创 建 的 数据 库 ) ， 要 么 保存 在 Web 服 务 器 上 。 


11.1 Room 架构 组 建 库 
Room 是 一 个 Jetpack 架 构 组 件 库 ， 它 文 持 使 用 Kotlin 注 解 类 来 定义 你 的 数 
据 库 结构 和 查询 ， 数 据 库 的 创建 和 访问 工作 也 因此 变 得 更 人 简单 。 


一 套 API、 一 些 注 解 类 和 一 个 编译 器 就 组 成 了 Room 工具 库 。Room API 
包含 一 些 用 来 定义 数据 库 和 创建 数据 库 实 例 的 类 。 注 解 类 用 来 确定 哪些 
类 需要 保存 在 数据 库 里 ， 哪 个 类 代表 数据 库 ， 哪 个 类 指定 数据 库 表 访问 
函数 这 样 的 事情 。 编 译 器 负责 处 理 注解 类 ， 生 成 数据 库 实现 代码 。 


要 使 用 Room， 首 先 要 添加 项 目 依 赖 。 如 代码 清单 11-1 所 示 ， 在 
app/build.gradle 文 件 中 ， 添 加 room-runtime 和 room-compiler 依 赖 。 


代码 清单 11-1 添加 依赖 项 (app/build.gradle) 
apply plugin: 'kotlin-android-extensions' 
apply plugin: 'kotlin-kapt' 
android ( 


} 


dependencies { 


implementation 'androidx.core:core-ktx:1.1.0-alpha04' 
implementation 'androidx.room:room-runtime:2.1.0-alpha04' 
kapt 'androidx.room:room-compiler:2.1.0-alpha04' 


在 app/build.gradle 文 件 的 顶部 ， 先 添加 一 个 Android Studio 新 插件 。 插 件 
用 于 给 IDE 添 加 新 功能 。 


Kotlin-kapt 是 Kotlin annotation processor tool (Kotlin 注 解 处 理工 具 ) 的 
缩写 形式 。 在 项 目 开 发 过 程 中 ， 你 会 用 工具 库 生 成 一 些 代码 ， 并 打算 在 
代码 中 直接 使 用 生成 的 类 。 但 默认 情况 下 ，Android Studio 看 不 到 这 些 生 


成 的 类 ， 即 使 强行 导入 ， 代 码 也 会 报错 。 添 加 Kotlin-kapt 插 件 就 是 让 
Android Studio 识 别 它 们 。 然 后 ， 你 就 可 以 直接 导入 使 用 了 。 


第 一 个 room-runtime 依 赖 是 Room API， 其 包含 你 定义 数据 库 时 需要 使 
用 的 一 些 类 和 注解 。 第 二 个 room-compiler 是 Room 编译 器 。 基 于 你 指 
定 的 各 类 注解 ， 它 会 生成 数据 库 实施 代码 文件 。 注 意 ，Room 编 译 器 使 
用 的 关键 字 是 kapt， 而 不 是 ijmplementation， 这 样 Room 工 具 库 生成 
的 类 文件 就 能 在 Android Studio 里 直接 使 用 。Kotlin-kapt， 感 谢 有 你 ! 
最 后 ， 别 忘 了 同步 app/build.gradle 文 件 。 配 置 好 项 目 依 赖 之 后 ， 接 下 来 
就 可 以 准备 待 存储 的 模型 层 了 。 

11.2 创建 数据 库 

使 用 Room 工 具 库 创建 数据 需要 以 下 三 个 步 又 。 

(1) 注解 模型 类 ， 使 之 成 为 一 个 数据 库 实体 。 

(2) 创建 数据 库 代 表 类 。 

(3) 创建 类 型 转换 器 ， 让 数据 库 能 够 处 理 模 型 数据 。 

稍 后 ， 你 会 看 到 ，Room 处 理 这 三 个 步骤 的 工作 既 简单 又 直接 。 


11.2.1 定义 实体 

Room 基于 你 定义 的 实体 为 应 用 构建 数据 库 表 。 实 体 是 你 创建 的 模型 
类 ， 使 用 @Entity 注 解 。 使 用 @Entity 注 解 一 个 类 ， 然 后 交 给 Room 处 理 ， 
一 张 数据 库 表 就 证 生 了 。 


要 想 在 数据 库 里 保存 Crime 对 象 ， 你 需要 把 Crime 类 改造 为 Room 实体 。 
打开 Crime.kt 文 件 ， 添 加 两 个 注解 ， 如 代码 清单 11-2 所 示 。 


代码 清单 11-2 创建 Crime 实 体 〈Crime.kt) 


@Entity 
data class Crime(@PrimaryKey val id: UUID = UUID.randomUUID(), 
var title: String = "" 


var date: Date = Date()， 

var isSolved: Boolean = false) 
第 一 个 @Entity 是 个 类 级 别 的 注解 ， 这 个 注解 表示 被 注解 的 类 定义 了 一 
张 或 多 张 数据 库 表 结构 。 这 里 ， 数 据 库 表 的 每 一 条 记录 就 代表 一 
个 Crime 对 象 。Crime 类 定义 的 每 一 个 属性 对 应 表 里 的 一 个 字段 ， 属 性 
名 就 是 字段 名 。 我 们 要 创建 的 crime 数 据 表 有 四 个 表 字 
Pe: id、title、date 和 issolved。 


另 一 个 @PrimaryKey 注 解 添 加 给 了 id 属性 。 这 个 注解 的 作用 是 指定 数据 
库 里 哪 一 个 字段 是 主键 (primary key) 。 主 键 是 数据 库 中 的 某 个 字段 ， 
其 值 在 一 条 记录 里 具有 唯一 性 ， 可 以 用 来 查找 单条 记录 。 对 每 一 

个 Crime 对 象 来 说 ， 其 id 属性 是 唯一 的 。 因 此 ， 我 们 把 @PrimaryKey 注 
解 添加 给 它 。 这 样 ， 就 可 以 使 用 Crime 的 id 从 数据 库 里 查找 到 单独 一 条 
We s 


搞定 了 Crime 类 的 实体 注解 ， 接 下 来 的 任务 是 创建 数据 库 类 。 
11.2.2 创建 数据 库 类 


实体 类 定义 数据 库 表 结构 。 同 一 个 实体 类 也 可 以 用 于 多 个 数据 库 ， 比 如 
一 个 应 用 用 到 多 个 数据 库 的 情况 。 这 种 情况 虽 不 多 见 ， 但 确实 会 有 。 有 
鉴于 此 ，Room 不 会 拿 到 一 个 实体 类 就 用 它 来 创建 数据 库 表 ， 除 非 你 明 
确 指 定 一 个 实体 类 和 一 个 数据 库 相 关联 。 


创建 数据 库 类 之 前 ， 首 先 创建 一 个 database 新 包 用 于 管理 数据 库 相 关 
的 源 代码 。 在 项 目 工具 窗口 中 ， 右 键 单 击 
com.bignerdranch.android.criminalintent LFX, it&fÉNew — Package 5 
项 ， 创 建 database 新 包 。 


现在 ， 在 database 包 里 ， 创 建 一 个 名 为 CrimeDatabase 的 新 类 ， 其 类 
定义 如 代码 清单 11-3 所 示 。 


代码 清单 11-3 ”创建 CrimeDatabase 类 
C database/CrimeDatabase.kt ) 


@Database(entities = [ Crime::class ], version=1) 
abstract class CrimeDatabase : RoomDatabase() { 


} 


@Database 注 解 告诉 Room，CrimeDatabase 类 就 是 应 用 里 的 数据 库 。 这 
个 注解 本 身 也 需要 两 个 参数 。 第 一 个 参数 是 实体 类 集合 ， 告 诉 Room 在 
创建 和 管理 数据 库 表 时 该 用 哪个 实体 类 。 这 里 只 传 入 了 Crime 类 ， 因 为 
整个 应 用 就 这 么 一 个 实体 。 


第 二 个 参数 是 数据 库 版 本 。 对 于 新 建 数 据 库 来 说 ， 版 本 号 应 该 是 1。 随 
痢 未 来 应 用 升级 ， 你 可 能 会 添加 新 的 实体 类 ， 或 者 给 现 有 实体 类 添加 新 
属性 。 如 果 是 这 样 ， 就 需要 修改 实体 类 集合 ， 增 加 数据 库 版 本 号 ， 让 

Room 知 道 数据 库 要 升级 了 。 


当前 ， 数 据 库 类 还 是 空 的 。CrimeDatabase 继 承 自 RoomDatabase， 被 
定义 成 一 个 抽象 类 ， 和 暂时 还 不 能 直接 实例 化 。 稍 后 会 学 习 如 何 使 用 
Room 实例 化 一 个 可 用 数据 库 。 


创建 类 型 转换 器 


Room 的 后 台数 据 库 引 擎 是 SQLite。SQLite 是 类 似 于 MySQL 和 
PostgreSQL 的 开源 关系 型 数据 库 。 (SQL 是 Structured Query Language 的 
缩写 形式 ， 是 同 数据 库 打 交道 的 一 种 标准 语言 。) 与 其 他 数据 库 不 同 ， 
SQLite 使 用 单个 文件 存储 数据 ， 读 写 数据 要 靠 SQLite 库 。Android 标 准 库 
包含 SQLite 库 以 及 配套 的 一 些 辅助 类 。 


通过 在 Kotlin 对 象 和 SQLite 数 据 库 之 间 建 立 一 个 对 象 关 系 映射 屋 ，Room 
能 让 你 轻松 优雅 地 使 用 SQLite 数 据 库 。 使 用 Room 时 ， 你 不 用 了 解 或 者 
关心 如 何 使 用 SQLite。 如 果实 在 感 兴趣 ， 可 以 访问 www.sqlite.org 查 看 
SQLite 使 用 手册 。 


Room 能 直接 在 后 人 台 SQLite 数 据 库 表 里 存储 基本 类 型 数据 ， 但 遇 到 其 他 

数据 类 型 束 会 有 问题 。Crime 类 要 靠 Date 和 UUID 对 象 支持 。 但 Room 默 
认 不 知道 该 如 何 存储 这 些 数据 类 型 。 这 就 需 要 采取 一 定 措施 来 转换 这 些 
数据 类 型 ， 让 Room 能 正确 存储 和 读 取 它们 。 


为 了 让 Room 知 道 该 如 何 做 数据 类 型 转换 ， 你 需要 指定 一 个 类 型 转换 器 
(type converter) 。 类 型 转换 器 会 告诉 Room 如 何 转 换 要 你 存 的 特定 类 型 
的 数据 。 要 完成 Date 和 UUID 的 数据 类 型 转换 ， 需 要 四 个 分 别 用 
@TypeConverter 注 解 的 函数 一 一 每 种 数据 类 型 两 个 ， 一 个 用 来 告诉 
Room 如 何 转换 成 可 保存 的 数据 类 型 ， 另 一 个 用 来 告诉 Room 如 何 再 恢复 


成 原来 的 数据 类 型 。 


在 database 包 里 ， 创 建 一 个 名 为 CrimeTypeConverters 的 新 类 ， 然 后 
为 Date 和 UUID 数 据 类 型 分 别 添加 两 个 转换 函数 ， 如 代码 清单 11-4 所 
me 


代码 清单 11-4 添加 TypeConverter 函 数 
( database/CrimeTypeConverters.kt ) 


class CrimeTypeConverters { 


@TypeConverter 
fun fromDate(date: Date?): Long? { 
return date?.time 


} 


@TypeConverter 
fun toDate(millisSinceEpoch: Long?): Date? { 
return millisSinceEpoch?.let { 
Date(it) 
} 
} 


@TypeConverter 

fun toUUID(uuid: String?): UUID? { 
return UUID.fromString(uuid) 

j 


@TypeConverter 
fun fromUUID(uuid: UUID?): String? { 
return uuid?.toString() 


} 


前 两 个 函数 用 于 处 理 Date 对 象 ， 后 两 个 函数 用 于 处 理 UUID 对 象 。 需 要 
导 包 时 ， 确 认 导 入 了 java.util.Date 版 本 的 Date 类 。 


仅 定 义 好 数据 类 型 转换 函数 还 不 行 ， 因 为 数据 库 类 不 知道 怎么 用 。 如 代 
码 清单 11-5 所 示 ， 你 还 需要 把 类 型 转换 类 添加 到 数据 库 类 里 。 


代码 清单 11-5 使 


用 CrimeTypeConverters (database/CrimeDatabase.kt) 


@Database(entities = [ Crime::class ], version=1) 
@TypeConverters(CrimeTypeConverters: :class) 
abstract class CrimeDatabase : RoomDatabase() { 


} 


通过 添加 @TypeConverters 注 解 ， 并 传 入 CrimeTypeConverters 类 ， 你 
Bu n 需要 转换 数据 类 型 时 ， 请 使 用 CrimeTypeConverters 类 
TREND ek 


至 此 ， 数 据 库 和 数据 库 表 的 定义 完成 了 。 


11.3 定义 数据 库 访问 对 象 


数据 库 表 的 内 容 要 能 编辑 和 访问 ， 否 则 也 就 失去 了 其 价值 。 和 数据 库 表 
交互 的 第 一 步 是 创建 一 个 数据 库 表 访问 对 象 ( 又 叫 DAO) 。DAO 对 象 
实际 就 是 定义 了 各 种 数据 库 操 作 函 数 的 一 个 接口 。 本 章 ，CriminalIntent 
应 用 的 DAO 对 象 需要 两 个 查询 函数 : 一 个 返回 数据 库 中 的 所 有 Crime 对 
象 ， 一 个 返回 匹配 给 定 UUID 的 单个 Crime 对 象 。 


在 database 包 里 ， 添 加 一 个 名 为 CrimeDao.kt 的 新 文件 。 然 后 打开 它 ， 
定义 一 个 名 为 CrimeDao 的 空 接 口 ， 并 使 用 Room 的 @Dao 注 解 它 ， 如 代 
码 清单 11-6 所 示 。 


代码 清单 11-6 ”创建 一 个 空 DAO 对 象 (database/CrimeDao.kt) 


@Dao 
interface CrimeDao { 


} 

@Dao 注 解 告诉 Room，CrimeDao 是 一 个 数据 访问 对 象 。 把 CrimeDao 和 
a Room 会 自动 给 CrimeDao 接 口 里 的 函数 生成 实现 
尺码 


既然 说 到 接口 函数 ， 那 就 往 CrimeDao 里 添加 两 个 查询 函数 ， 如 代码 清 
单 11-7 所 示 。 


代码 清单 11-7 添加 数据 库 查 询 疯 数 Cdatabase/CrimeDao.kt) 


@Dao 
interface CrimeDao { 


@Query("SELECT * FROM crime") 
fun getCrimes(): List<Crime> 


@Query("SELECT * FROM crime WHERE id=(:id)") 
fun getCrime(id: UUID): Crime? 


@Query 注 解 表明 ，getCrimes() 和 getCrime(UUID) 是 从 数据 库 读 取 数 
据 ， 不 是 插入 、 更 新 或 删除 数据 。DAO 接 口 里 查询 函数 的 返回 类 型 也 就 
是 数据 库 和 查询 要 返回 数据 的 类 型 。 


@Qnuery 注 解 需要 包含 SQL 指令 的 字符 串 参 数 。 大 多 数 情 况 下 ， 即 便 对 
SQL 知之 甚 少 也 不 影响 你 正常 使 用 Room。 如 果 有 兴趣 学 习 ， 可 访问 
www.sqlite.org 查 看 SQL 语法 专区 。 


SELECT * FROM crime 语 句 告诉 Room 取出 crime 数 据 库 表 里 所 有 记录 
及 其 所 有 字段 。SELECT * FROM crime WHERE id=(:id) 是 取出 匹配 
给 定 ID 的 某 条 记录 的 所 有 字段 。 

现在 ， 至 少 对 本 章 来 说 ，CrimeDao 接 口 实现 基本 完成 了 。 第 12 章 会 添 
加 更 新 数据 的 函数 。 第 14 章 会 添加 插入 新 数据 的 函数 。 


接 下 来 是 把 DAO 类 和 数据 库 关 关联 起 来 。 既然 CrimeDao 是 个 接口 ， 
Room 就 会 负责 实现 它 ， 当 然 ， 前 提 是 你 要 让 数据 库 类 生成 一 个 DAO 的 
实例 。 


为 关联 DAO， 打 开 CrimeDatabase.kt， 添 加 一 个 返回 类 型 是 CrimeDao 的 
抽象 函数 ， 如 代码 清单 11-8 所 示 。 


代码 清单 11-8 在 数据 库 类 里 登记 
DAO (database/CrimeDatabase.kt ) 


@Database(entities = [ Crime::class ], version=1) 
@TypeConverters(CrimeTypeConverters: :class) 
abstract class CrimeDatabase : RoomDatabase() { 


abstract fun crimeDao(): CrimeDao 


现在 ， 数 据 库 创建 后 ，Room 会 生成 DAO 的 具体 实现 代码 。 然 后 ， 你 可 
以 引用 到 它 ， 调 用 里 面 定义 的 各 个 函数 与 数据 库 交 互 。 


11.4 使 用 仓库 模式 访问 数据 库 
要 访问 数据 库 ， 需 要 使 用 Google 在 应 用 架构 指导 里 建议 的 仓库 模式 


(repository pattern) 。 


RETR Y MAARE PS TEV [el I — ES TE RE ATE 

取 和 保存 数据 ， 无 论 是 从 本 地 数据 库 ， 还 是 远程 服务 器 。UI 代 码 直 接 从 

| 的 数据 ， 不 关心 如 何 与 数据 库 打 交道 《这 是 仓库 内 部 的 
Jo 


CriminalIntent 是 个 简单 应 用 ， 仓 库 只 要 处 理 数据 库 数据 读 取 就 可 以 了 。 
在 com.bignerdranch.android.criminalintent 包 中 ， 创 建 一 个 名 


为 CrimeRepository 的 新 类 ， 在 其 中 定义 一 个 伴生 对 象 ， 如 代码 清单 
11-9 所 示 。 


代码 清单 11-9 实现 仓库 类 (CrimeRepository.kt) 


class CrimeRepository private constructor(context: Context) { 


companion object { 
private var INSTANCE: CrimeRepository? = null 


fun initialize(context: Context) { 
if (INSTANCE == null) { 
INSTANCE = CrimeRepository(context) 
} 
} 


fun get(): CrimeRepository { 
return INSTANCE ?: 
throw IllegalStateException("CrimeRepository must be initialize 


CrimeRepository 是 个 单 例 (singleton) ， 也 就 是 说 ， 在 应 用 进程 里 ， 


只 会 有 一 个 实例 。 


只 要 应 用 还 在 内 存 里 ， 单 例 就 会 一 直 在 那里 。 因 此 ， 保 存在 单 例 里 的 属 
性 不 受 activity 和 fragment 生 命 周 期 变化 的 影响 。 不 过 ， 要 是 Android 从 内 
存 里 删除 了 应 用 ， 单 例 目 然 也 就 不 复 存 在 了 。 显 然 CrimeRepository 
单 例 不 适合 持久 化 保存 数据 。 相 反 ， 它 只 是 应 用 里 crime 数 据 的 主人 ， 
为 在 控制 类 之 间 传 递 数据 提供 方便 。 


要 让 CrimeRepository 成 为 单 例 ， 你 需要 在 伴生 对 象 里 添加 两 个 函 
数 : 一 个 初始 化 生成 仓库 新 实例 ， 一 个 读 取 仓库 数据 。 另 

外 ，CrimeRepository 类 的 构造 函数 还 用 了 private 关 键 字 ， 以 此 保证 
不 让 其 他 类 揭 乱 生成 新 的 类 实例 。 


注意 ， 如 果 在 CrimeRepository 的 initialize() 函 数 执行 之 前 有 人 调 
用 数据 读 取 函 数 ， 它 就 会 抛 出 ILlegalSstateException 异 常 。 因 此 ， 
你 需要 在 应 用 启动 后 就 初始 化 CrimeRepository。 


为 了 在 应 用 一 局 动 就 元 成 这 什 事 ， 可 以 创建 一 个 Application 子 类 。 这 
样 就 能 掌握 应 用 的 生命 周期 信息 了 。 创 建 一 个 名 

Criminal IntentApplicationty 类 ， 让 它 继 承 Application 类 ， 然 
Ja tiApplication.onCreate() KA BEIT CrimeRepositoryRMN 
始 化 ， 如 代码 清单 11-10 所 示 。 


代码 清单 11-10 ”创建 Application 子 类 
(CriminalIntentApplication.kt) 


class CriminalIntentApplication : Application() { 


override fun onCreate() { 
super.onCreate() 
CrimeRepository.initialize(this) 


} 


} 


类 似 Activity.onCreate(...)， 应 用 一 加 载 到 内 存 里 ， 系 统 就 会 调 
用 Application.onCreate() 函 数 。 对 于 这 种 一 次 性 的 初始 化 工 
作 ，Application.onCreate() 函 数 很 不 错 。 


应 用 程序 实例 在 应 用 局 动 后 创建 ， 在 应 用 进程 被 销毁 时 销毁 ， 不 会 像 


activity 和 fragment 那 样 时 常 被 销毁 和 重建 。 对 于 CriminalIntent 心 用 来 
说 ， 你 唯一 要 窗 盖 的 生命 周期 函数 是 Application.onCreate()。 


稍 后 ， 还 要 把 应 用 实例 作为 Context 对 象 传 给 CrimeRepository。 只 要 
应 用 进程 还 在 内 存 里 ，Context 对 象 就 是 有 效 的 ， 因 此 
在 CrimeRepository 里 引用 它 很 安全 。 


不 过 ， 系 统 要 能 使 用 应 用 程序 类 ， 还 需要 在 manifest 文 件 里 先 登 记 。 打 
开 AndroidManifest.xml 文 件 ， 使 用 android:name 属 性 登记 
好 CriminalIntentApplication， 如 代码 清单 11-11 所 示 。 


代码 清单 11-11 登记 CriminalIntentApplication 子 类 
(manifests/AndroidManifest.xml ) 


«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com. bignerdranch. android.criminalintent"> 


<application 
android:name=".CriminalIntentApplication" 
android: allowBackup="true" 
i^» 


</application> 


</manifest> 


登记 好 CriminalIntentApplication 之 后 ， 应 用 一 启动 ， 操 作 系统 就 
会 调用 CriminalIntentApp1lication 的 onCreate() 函 数 。 然 
后 ，CrimeRepository 就 完成 了 初始 化 ， 欢 迎 其 他 对 象 随时 来 访 。 


接 下 来 ， 在 CrimeRepository 里 添加 两 个 属性 ， 用 来 保存 数据 库 和 
DAO 对 象 ， 如 代码 清单 11-12 所 示 。 


代码 清单 11-12 配置 仓库 属性 〈CrimeRepository.kt) 


private const val DATABASE NAME = "crime-database" 


class CrimeRepository private constructor(context: Context) { 


private val database : CrimeDatabase - Room.databaseBuilder( 
context.applicationContext, 


CrimeDatabase::class.java, 
DATABASE NAME 
).build() 


private val crimeDao = database.crimeDao() 


companion object { 


j 


Room.databaseBuilder() 使 用 三 个 参数 具 ee 
抽象 类 。 第 一 个 参数 是 Context 对 象 ， 因 为 数据 库 要 访问 文件 系统 。 
里 传 入 的 是 应 用 上 下 文 。 之 前 说 过 ， EEA Mace SHERI. 


第 二 个 参数 是 Room 用 来 创建 数据 库 的 类 。 第 第 三 个 参数 是 Room 将 要 创建 
HR HE SC DEM A 由 于 没有 外 部 访问 需要 ， 因 此 这 里 定义 使 用 了 和 
ATIE E E 


接 下 来 ， 完 善 CrimeRepository 类 ， 让 其 他 类 能 通过 它 访问 到 数据 
库 。 ee 13 所 示 ， 添 加 两 个 仓库 函数 ， 访 问 到 DAO 对 象 的 相 
应 数据 库 操作 函数 。 


代码 清单 11-13 ”添加 仓库 函数 〈CrimeRepository.kt) 


class CrimeRepository private constructor(context: Context) { 


private val crimeDao = database.crimeDao() 


fun getCrimes(): List«Crime» - crimeDao.getCrimes() 


fun getCrime(id: UUID): Crime? - crimeDao.getCrime(id) 


companion object { 


} 


既然 Room 提供 ktDAO 里 的 查询 方法 实现 ， 我 们 就 通过 仓库 调用 它们 。 
样 处 理 ， 仓 库 代 码 不 仅 简 洁 ， 还 易于 理解 。 


看 到 这 里 ， 你 可 能 会 有 忙活 了 半天 没 干 多 少 实 事 的 感觉 。 不 要 懂 ， 稍 后 
我 们 就 会 添加 一 些 功 能 来 封装 仓库 需要 处 理 的 工作 。 


11.5 测试 数据 库 访 问 


CrimeRepository 搞 定 了 ， 要 测试 数据 库 访 问 还 得 做 最 后 一 件 事 。 当 

前 ，crime 数 据 库 还 没有 数据 。 为 提高 效 紊 ， 我 们 需要 上 传 填充 了 数据 

的 数据 库 文件 到 模拟 器 上 。 本 书 随 书 文件 里 提供 了 该 数据 库 文 件 ， 请 下 
载 解压 后 使 用 。 


当然 ， 也 可 以 编码 生成 种 子 数据 写 入 数据 库 中 ， 比 如 之 前 使 用 的 100 个 
crime 数 据 。 不 过 ， 我 们 还 没 实现 同 数据 库 写 入 数据 的 DAO 函 数 〈 第 14 
章 会 实现 ) 。 上 传 预先 准备 的 数据 库 文件 不 仅 省 了 修改 应 用 代码 的 麻 
烦 ， 还 能 让 你 借 此 机 会 使 用 Device File Explorer 查 看 一 下 本 地 存储 系统 
里 的 内 容 。 


说 到 但 看 设备 文件 ， 就 不 得 不 提 上 传 数 据 库 文件 做 测试 的 一 个 缺陷 。 你 
只 能 访问 应 用 的 私有 文件 (数据 库 文件 所 在 的 目录 ， 且 还 要 在 模拟 器 或 
root 过 的 设备 上 ) 。 想 把 数据 库 文件 上 传 到 物理 设备 是 行 不 通 的 。 


上 传 测试 数据 


Android 设 备 上 的 应 用 都 有 一 个 沙 盒 目 录 。 将 文件 保存 在 沙 盒 中 ， 可 以 
阻 正 其 他 应 用 甚至 是 设备 用 户 的 访问 和 示 探 。 (当然 ， 如 果 设 备 被 
root， 那 用 户 束 可 以 为 所 欲 为 了 。 ) 

应 用 的 沙 盒 目录 是 data/data/ 后 跟 应 用 的 包 名 称 。 例 如 ，CriminalIntent/Y 


用 的 沙 盒 目 录 是 data/data/com.bignerdranch.android.criminalintent。 


要 上 传 数 据 库 文 件 ， 首 先 要 确认 模拟 器 已 经 启动 运行 ， 然 后 在 Android 
Studio 里 打开 Device File Explorer 工 具 栏 窗口 。 如 图 11-2 所 示 ， 文 件 浏 览 
器 面板 会 展示 模拟 上 的 所 有 文件 。 


图 11-2 


Device File Explorer go — 
mE Emulator Pixel 2 API 28 Android 9, API 28 hd 
Name | Permissions -Date Size 
i — "c—— Link target: /system/bin | 0B 
> BË bin Irw-r--r-- 2009-01-01 03:00 118 
: cache drwxrwx--- 2009-01-01 03:00 4 KB 
» config drwxr-xr-x 2019-05-10 14:24 0B 
ld Irw-r--r-- 2009-01-01 03:00 17 B 
b data drwxrwx--x 2019-03-10 22:31 4KB 
dev drwxr-xr-x 2019-05-10 14:24 2.6 KB 
> Bf etc Irw-r--r-- 2009-01-01 03:00 11B 
» lost+found drwx------ 2009-01-01 03:00 16 KB 
mnt drwxr-xr-x 2019-05-10 14:24 240 B 
odm drwxr-xr-x 2009-01-01 03:00 4 KB 
> oem drwxr-xr-x 2009-01-01 03:00 AKB 
E proc dr-xr-xr-x 2019-05-10 14:24 0B 
> BË product Irw-r--r-- 2009-01-01 03:00 158 
p sbin drwxr-x--- 2009-01-01 03:00 4 KB 
A sdcard Irw-r--r-- 2009-01-01 03:00 218 
storage drwxr-xr-x 2019-05-10 14:24 100 B 
Sys dr-xr-xr-x 2019-05-10 14:24 0B 
system drwxr-xr-x 2009-01-01 03:00 4 KB 
» vendor drwxr-xr-x 2009-01-01 03:00 4 KB 
7? bugreports Irw-r--r-- 2009-01-01 03:00 50B 
? charger Irw-r--r-- 2009-01-01 03:00 13B 
A default.prop Irw------- 2009-01-01 03:00 238 


设备 文件 浏览 器 窗口 


Device File Explorer 


BEEK flCriminalIntent V Hl 2b AHK, Bcd Frdata/dataH ae, FREID 

对 应 项 目 包 名 命名 的 子 目 录 ， 如 图 11-3 所 示 。 此 目录 下 的 文件 就 是 应 用 

其 他 应 用 没有 权限 访问 。 这 里 就 是 要 上 传 数据 库 文件 
‘ 方 。 


Device File Explorer à - 


| BB Emulator Book Screenshot Device Android 9, API 28 Y 
Name | Permissions Date Size 
"occ WUITTAITUTUIU, Walla er TTVEDIUNCI UIWAIWA""A LUIV"UZ*U/ TI. 19 4 ND 
com.android.wallpaperbackup drwxrwx--x — 2019-02-07 11:13 4 KB 
com.bignerdranch.android. beatbox drwxrwx--x — 2019-02-07 11:13 4 KB 
Com.bignerdranch.android.criminalintent  drwxrwx--x —— 2019-02-07 11:13 
com.bignerdranch.android.geoquiz drwxrwx--x — 2019-02-07 11:13 4KB 


图 11-3 MAW HK 


为 上 传 我 们 准备 的 databases 目 录 ， 右 键 单 击 项 目 包 名 目录 ， 选 择 
Upload... 末 单项 ， 如 图 11-4 所 示 。 


= | — com.hianerdranch.android.criminalintent 


[e| New 
» G 
> p, fi Fl Save As... CUPS 
co Upload... 个 分 QO R 
com * Delete... BS ourdaggersh 
com à ourdaggersh 
com S Synchronize t 


com E Copy Path nr T 


com.google.android.apps.docs 
图 11-4 上 传 database 文 件 


在 随后 弹出 的 文件 浏览 窗口 ， 找 到 随 书 文件 本 章 对 应 目录 里 的 数据 库 文 
件 。 上 传 文件 时 ， 确 认 上 传 了 整个 databases 目 录 。Room 操 作 的 数据 库 
文件 都 要 放 在 一 个 名 为 databases 的 目录 里 ， 否 则 它 会 罢工 。 完 成 文件 上 
传 后 ， 你 的 应 用 沙 盒 目录 应 该 如 图 11-5 所 示 。 


com.bignerdranch.android.criminalintent 
cache 
code_cache 


2 crime-database 

2 crime-database-shm 

2 crime-database-wal 
files 


图 11-5 已 上 传 的 数据 库 文件 


上 传 完 数据 库 文件 ， 现 在 可 以 使 用 仓库 模式 来 查询 数据 库 了 。 当 

前 ，CrimeListViewModel 上 自己 创建 了 100 个 供 展示 的 Crime 对 象 。 删 除 
这 段 数 据 生成 代码 ， 改 用 CrimeRepository 的 getCrimes() 函 数 从 数 
据 库 读 取 crime 数 据 ， 如 代码 清单 11-14 所 示 。 


代码 清单 11-14 在 ViewModel 里 访问 仓库 
(CrimeListViewModel.kt) 


class CrimeListViewModel : ViewModel() { 


—3 


private val crimeRepository - CrimeRepository.get() 
val crimes - crimeRepository.getCrimes() 


} 


现在 ， 运 行 应 用 来 检验 成 果 。 出 人 意料 的 是 ， 应 用 骨 江 了 。 


不 要 惰 ， 这 是 意料 之 中 的 事 《〈 不 好 意思 ， 卖 了 个 关子 ， 这 里 是 指 我 们 早 
有 预料 ) 。 在 Logcat 里 查看 异常 ， 看 看 哪里 出 了 问题 : 


java.lang.IllegalStateException: Cannot access database on the main thread 


it may potentially lock the UI for a long period of time. 


Room 抛 出 了 异常 。 它 罢工 了 ， 因 为 你 试图 在 主线 程 上 访问 数据 库 。 下 
一 节 ， 我 们 将 学 习 Android 的 线程 模型 、 主 线程 的 使 用 场景 ， 以 及 哪些 
工作 可 以 运行 在 主线 程 上 等 与 线程 相关 的 知识 。 然 后 ， 我 们 会 把 操作 数 
据 库 的 任务 移 到 后 台 线 程 上 去 。 这 样 就 能 解决 异 角 错误， 让 Room 满 
意 ， 应 用 也 就 不 会 月 训 了。 


11.6 ”应 用 线程 

读 取 数据 库 是 个 党 时 的 事情 ， 无 法 立即 完成 。 因 而 ，Room 不 允许 在 主 
线程 上 执行 任何 数据 库 操作 。 如 强行 为 之 ，Room 就 会 抛 出 你 刚刚 看 到 
HJIllegalStateException# i. 


为 什么 这 样 呢 ? 要 理解 背后 的 原因 ， 你 需要 知道 线程 是 什么 、 主 线程 是 
什么 ， 以 及 主线 程 应 该 做 什么 。 


线程 是 一 个 单一 执行 序列 。 单 个 线程 中 的 代码 会 逐步 执行 。 所 有 

Android 应 用 的 运行 都 是 从 主线 程 开始 的 。 然 而 ， 主 线程 并 不 是 像 线程 

那样 的 预定 执行 序列 。 相 反 ， 它 处 于 一 个 无 限 循环 的 运行 状态 ， 等 着 用 

户 或 系统 能 发 要 件 。 一 旦 有 事件 角 发 ， 主 线程 便 执行 代码 做 册 响应， 如 
11-64TA o 


线程 主线 程 
| (来 自 Android 系 统 
| 或 用 户 ) 
l eL J 
I Fs E 任务 事件 
i / 
1 v 

(运行 某 些 代码 ) 人 

I ` (处理 任 务 事件 ) 
I N F. 
i SC — ^ 
l 

完成 


图 11-6 “一般 线程 与 主线 程 


把 应 用 想象 成 一 家 大 型 圣 店 ， 内 电 侠 是 这 家 鞋 店 唯一 的 员工 。 为 了 让 客 
户 满意 ， 他 要 做 很 多 事 ， 比 如 布置 商品 、 为 顾客 取 鞋 、 为 顾客 量 太 二 
等 。 内 电 侠 并 非 浪 得 虚名 ， 即 便 所 有 工作 都 由 他 一 人 完成 ， 客 户 也 能 得 
到 及 时 啊 应 ， 感 到 满意 。 


为 了 及 时 完成 任务 ， 闪 电 侠 不 能 在 一 件 事情 上 耗 太 久 。 如 果 一 批 货 和 于 了 
怎么 办 ? 这 时 ， 必 须 有 人 花 时 间 打 电话 调查 此 事 。 假 设 让 闪电 侠 去 做 ， 
那 店 里 等 候 的 顾客 就 要 不 耐烦 了 。 

内 电 侠 惑 像 应 用 里 的 主线 程 。 它 运行 痢 所 有 更 新 UI 的 代码 ， 其 中 包括 啊 
心 activity 的 启动 、 按 钮 的 点 击 等 不 同 UI 相 关 事 件 的 代码 。《“ 由 于 响应 的 
事件 基本 都 与 UI 相 关 ， 因 此 主线 程 有 时 也 叫 UI 线 程 。) 


事件 处 理 循环 让 UI 代 码 总 是 按 顺 序 执行 。 这 样 ， 事 件 就 能 一 件 件 处 理 ， 


不 用 担心 互相 冲突 ， 同 时 代码 也 能 够 快速 执行 ， 及 时 啊 应 。 目 前 ， 我 们 
编写 的 所 有 代码 都 是 在 主线 程 中 执行 的 。 
后 台 线 程 


数据 库 访 问 如 同 致电 分 销 商 : 相 比 其 他 任务 ， 它 更 耗 时 。 等 待 响应 期 
间 ，UI 训 无 反应 ， 这 可 能 会 导致 应 用 无 啊 应 Capplication not 
responding, ANR) 现象 发 生 。 


如 果 Android 系 统 监控 服务 确认 主线 程 无 法 啊 应 重要 事件 ， 比 如 点 击 回 
退 键 等 ， 则 ANR 会 及 生 。 用 户 束 会 看 到 如 图 11-7 所 示 的 画面 。 


Criminallntent isn't responding 


x Close app 


© Wat 


图 11-7 ”应 用 无 响应 
回 到 假想 的 鞋 店 中 ， 要 解决 问题 ， 自 然 想 到 再 雇 一 名 闪电 侠 负 责 联 络 分 


销 商 。Android 系 统 中 的 做 法 与 之 类 似 ， 即 创建 一 个 后 台 线 程 ， 然 后 从 
该 线程 访问 数据 库 。 


给 应 用 添加 后 台 线 程 时 ， 需 要 考虑 以 下 两 个 重要 原则 。 


。 所 有 耗 时 任务 都 应 该 在 后 台 线 程 上 完成 。 这 能 够 保证 主线 程 有 空 
处 理 UI 相 关 的 任务 ， 以 使 UI 及 时 啊 应 用 户 操作 。 

e UI 只 能 在 主线 程 上 更 新 。 试 图 从 后 台 线 程 更 新 UI 会 让 应 用 报错 ， 
因此 ， 后 全 线程 生成 的 UI 更 新 数据 都 要 确保 发 到 主线 程 上 执行 。 


Android 有 很 多 办 法 能 让 你 在 后 台 线 程 上 执行 任务 。 我 们 会 在 第 24 章 中 
学 习 如 何 发 起 异步 网 络 请 求 ， 在 第 25 章 中 学 习 如 何 使 用 Handler 处 理 一 
些 后 台 小 任务 ， 在 第 27 章 中 学 习 如 何 使 用 WorkManager 执 行 周期 性 的 后 
台 任 务 。 


对 CriminalIntent 应 用 来 说 ， 要 想 在 后 台 线 程 上 访问 数据 库 ， 办 法 有 两 
个 。 本 章 我 们 会 首先 学 习 使 用 LiveData 来 封装 数据 库 查 询 数 据 ， 然 后 
在 第 12 章 和 第 14 章 中 会 学 习 使 用 Executor 来 插入 和 更 新 数据 库 数 据 。 


11.7 使 用 LiveData 


LiveData 是 Jetpack 1ifecycle-extensions 库 里 的 一 个 数据 持 有 类 。 
Room 原 生 文 持 与 LiveData 协 同 工 作 。 在 第 4 章 中 ， 你 已 经 在 
app/build.gradle 文 件 里 添加 过 1ifecycle-extensions 库 依赖 。 现 在 可 
以 在 项 目 里 直接 用 LiveData 类 了 。 


Google 开 发 LiveData 的 目的 是 让 应 用 不 同 模块 之 间 的 数据 传递 简单 一 
些 ， 比 如 从 CrimeRepository 到 显示 crime 数 据 的 
CrimeListFragment。 另 外 ，LiveData 也 能 在 线程 之 间 传 递 数 据 。 显 
然 ， 之 前 讨论 的 线程 使 用 规则 ， 它 肯定 会 严格 遵守 。 


你 可 以 在 Room DAO 里 配置 查询 返回 LiveData，Room 会 自动 在 后 台 线 
程 上 执行 查询 操作 ， 完 成 后 会 把 结果 数据 发 布 到 LiveData 对 象 。 你 再 
配置 activity 或 fragment 来 观察 目标 LiveData 对 象 。 这 样 ， 被 观察 的 
LiveData 一 准备 就 绪 ， 你 的 activity 或 fragment 束 会 在 主线 程 上 收 到 结 
通知 。 


本 章 会 重点 关注 并 使 用 LiveData 的 路 线程 沟通 的 功能 ， 借 助 它 执行 数 
据 库 查询 操作 。 首 先 ， 打 开 CrimeDao.kt， 更 新 数据 查询 函数 ， 改 
用 LiveData 对 象 作为 其 返回 数据 类 型 ， 如 代码 清单 11-15 所 示 。 


代码 清单 11-15 在 DAO 里 返回 LiveData (database/CrimeDao.kt) 


@Dao 
interface CrimeDao { 


(QQuery ("SELECT * FROM crime") 


c t€rámes Q2 Listecri 


fun getCrimes(): LiveData<List<Crime>> 


@Query ("SELECT * FROM crime WHERE id=(:id)") 


— —fun-getCrime(id:—UUID):—Crime? 


fun getCrime(id: UUID): LiveData<Crime?> 


} 


从 DAO 类 返回 LiveData 实 例 ， 束 是 告诉 Room 要 在 后 台 线 程 上 执行 数据 
库 查 询 。 查 询 到 crime 数 据 后 ，LiveData 对 象 会 把 结果 发 到 主线 程 并 通 
知 UI 观 察 者 。 


接 下 来 ， 如 代码 清单 11-16 所 示 ， 让 CrimeRepository 里 的 查询 函数 也 
返回 LiveData 对 象 。 


代码 清单 11-16 MCrimeRepositoryi& [Al 
LiveData (CrimeRepository.kt ) 


class CrimeRepository private constructor(context: Context) { 


private val crimeDao = database.crimeDao() 


c t€rámes Q2 Listecri No ee Oe 


fun getCrimes(): LiveData<List<Crime>> = crimeDao.getCrimes() 


c t€ráme Cid: UUED): Crime? — crimeDao.get€rimeCid) 


fun getCrime(id: UUID): LiveData«Crime?» - crimeDao.getCrime(id) 


XI 9€ LiveData 


为 显示 数据 库 中 的 crime 数 据 ， 让 CrimeListFragment 观 察 从 
CrimeRepository.getCrimes() 返 回 的 LiveData。 


首先 ， 打 开 CrimeListViewModel.kt， 给 crimes 属 性 换个 更 醒目 的 名 字 
如 代码 清单 11-17 所 示 。 


代码 清单 11-17 在 ViewModel 里 访问 数据 仓库 
(CrimeListViewModel.kt) 


class CrimeListViewModel : ViewModel() { 


private val crimeRepository = CrimeRepository.get() 
val 


—— crimeListLiveData = crimeRepository.getCrimes() 


如 代码 清单 11-18 所 示 ， 由 于 CrimeListViewModel 会 暴露 来 自 数 据 仓 
库 的 LiveData， 你 需要 重新 整理 CrimeListFragment 类 。 首 先 删 

除 onCreate(. ..) 实 现 函数 《既然 该 函数 内 引用 的 
crimeListViewModel.crimes 不 存在 了 ， 之 前 的 日 志 记 录 也 就 不 需要 
T) 。 然 后 ， 移 除 updateUI() 函 数 里 的 
crimeListViewModel.crimes 引 用 ， 给 它 添加 一 个 接受 crime 集 合 的 参 
数 。 最 后 ， 如 代码 清单 11-18 所 示 ， 从 onCreateView(.. . ) 里 删 

除 updateUI() 。 稍 后 会 换个 地 方 调用 它 。 


代码 清单 11-18 ” 移 除 旧 版 本 ViewMode13 引 用 
(CrimeListFragment.kt ) 


private const val TAG = "CrimeListFragment" 


class CrimeListFragment : Fragment() { 


—3 


override fun onCreateView( 


): View? { 


crimeRecyclerView.layoutManager - LinearLayoutManager(context) 


— —wupdateUt() 


return view 


private fun updateUI(crimes: List«Crime») ( 


] - imeListViewModel-cei 


adapter - CrimeAdapter(crimes) 
crimeRecyclerView.adapter - adapter 


MÆ, S 3CrimeListFragment, Jr 
CrimeRepository.getCrimes()ik|MlH]crimeListLiveData. PE 
然 CrimeListFragment 改 用 数据 库 里 的 crime 数 据 填 充 目 

标 crimeRecyclerView， 那 束 先 用 一 个 空 crime 集 合 初 始 化 循环 视图 的 
adapter。 然 后 在 LiveData 有 了 新 数据 后 ， 更 新 给 crimeRecyclerView 
的 adapter。 如 代码 清单 11-19 所 示 。 


代码 清单 11-19 ”关联 RecyclerView (CrimeListFragment.kt) 


private const val TAG = "CrimeListFragment" 


class CrimeListFragment : Fragment() { 


private lateinit var crimeRecyclerView: RecyclerView 


— —pPivate-var—adapter:—CrimeAdapter?—-—null 


private var adapter: CrimeAdapter? - CrimeAdapter(emptyList()) 
override fun onCreateView( 
): View? { 


crimeRecyclerView.layoutManager - LinearLayoutManager(context) 
crimeRecyclerView.adapter - adapter 
return view 


} 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 
super.onViewCreated(view, savedInstanceState) 
crimeListViewModel.crimeListLiveData.observe( 
viewLifecycleOwner, 
Observer { crimes -> 
crimes?.let { 
Log.i(TAG, "Got crimes ${crimes.size}") 
updateUI (crimes) 


上 述 代 码 中 ，LiveData.observe(Lifecycle0wner，0bserver) 函 数 
用 来 给 LiveData 实 例 登 证 观察 者 和 类 似 activity 或 fragment 这 
样 的 其 他 组 件 同 呼吸 共 命 运 


observe(. . .) 函 数 的 第 二 个 参数 是 一 个 Observer 实现 。 这 个 对 象 负 员 
响应 LiveData 的 新 数据 通知 。 XE, MEHRI 

在 crimeListLiveData 的 crime 和 集合 数据 有 更 新 时 执行 。 2 E 
Speen 只 要 crime 属 性 有 值 ， 观 察 者 对 象 束 会 打印 出 日 志 


除非 退 定 ， 或 者 让 你 的 0bserver 实 现 不 再 监听 目标 LiveData 的 变化 ， 
个 则 ， 即 便 fragment 的 视图 处 于 失效 状态 《比如 被 销毁 了 ) ， 你 的 
Observer 实现 也 会 尝试 更 新 它 。 试 图 更 新 失效 状态 视图 会 让 应 用 骨 


in. 


这 时 ， 就 该 LiveData.observe(...) 的 第 一 个 参数 LifecycleOwner 
登场 了 。 你 定 的 0bserver 实 现 的 生命 8 周期 会 和 LifecycleOwner 所 代 
表 的 Android 组 件 的 生命 周期 保持 一 臻 。 在 上 述 代 码 中 ， 束 是 指 你 的 
Observer 实现 和 CrimeListFragment 视 图 的 生命 周期 保持 一 致 了 。 


只 要 Observer 实现 同步 的 生命 周期 拥有 者 Clifecycle owner) 处 于 有 效 
生命 周期 状态 ，LiveData 对 象 一 有 数据 更 新 就 会 通知 它 的 观察 者 。 当 
与 Observer 实现 有 着 相同 生命 证 周期 的 关联 对 象 不 存在 了 ，LiveData 对 
象 会 上 自动 和 Observer 实现 解除 订阅 关系 。 因 为 LiveData 能 啊 应 生命 周 
期 变化 ， 所 以 它 还 有 个 名 字 叫 生命 周期 感知 组 件 (ifecycle-aware 
component) 。 有 关 和 生命 周期 感知 组 件 的 更 多 内 容 ， 详 见 第 25 章 。 


生命 周期 拥有 者 是 实现 了 LifecycleOwner 接 口 并 包含 Lifecycle 对 象 
的 一 种 Android 组 件 。Lifecycle 对 象 用 来 记录 Android 生 命 周 期 当前 状 
dx. (之 前 说 过 ，activity、fragment、view， 其 至 是 应 用 进程 本 身 都 有 
它们 各 自 的 生命 周期 。) 像 已 创建 和 继续 运行 这 样 的 生命 周期 状态 可 以 
在 Lifecycle.State 里 枚 举 。 你 可 以 使 

用 Lifecycle. Se 数 查 询 Lifecycle 的 状态 ， 或 者 
用 它 登记 接收 生命 周期 状态 变化 通知 。 


AndroidXx 版 Fragment 束 是 一 个 生命 周期 拥有 者 。 它 实现 了 
LifecycleOwner 接 口 ， 有 一 个 表示 fragment 实 例 生 命 周 期 状态 的 


Lifecycle 对 象 。 


fragment 视 图 的 生命 周期 由 FragmentViewLifecycleOwner (每 
个 Fragment 都 有 一 个 FragmentViewLifecycleOwner 实 例 ) 记录 和 管 
理 。 


以 上 代码 中 ， 通 过 把 viewLifecycleOwner 传 给 observe(...) 函 数 ， 
你 观察 到 同步 的 不 是 fragment 上 自身 的 生命 周期 ， 而 是 fragment 视 图 的 生 
命 周期 。 虽 然 是 两 个 不 同 的 生命 周期 ， 但 fragment 视 图 的 生命 周期 和 
Fragment 实 例 自 映 的 生命 周期 是 一 致 的 。 不 过 ， 如 果 保 留 fragment， 你 
可 以 改变 这 种 默认 行为 。 我 们 会 在 第 25 章 学 习 更 多 视图 生命 周期 和 保留 
fragment 的 知识 。 


Fragment .onViewCreated(...) 是 在 Fragment.onCreateView(...) 
函数 之 后 调用 的 ， 调 用 到 它 表 明 fragment 视 图 层级 结构 已 创建 完毕 。 

在 onViewCreated(...) 函 数 里 观察 LiveData 可 以 保证 展示 crime 数 据 
的 视图 已 准备 完毕 。 这 也 解释 了 为 什么 你 传 给 observe() 函数 的 不 是 
fragment 上 自身 ， 而 是 viewLifecycle0wner (fragment 视 图) 。 只 有 你 的 
oo 图 处 于 有 效 状 态 〈 还 在 屏幕 上 ) ， 你 才 需 要 接收 crime 数 据 更 


从 数据 库 读 取 到 crime 数 据 后 ， 你 定义 的 Observer 实现 就 会 打印 日 志 信 
息 ， 发 送 收 到 的 数据 给 updateUI() 准 备 adapter。 


至 此 ， 一 切 都 准备 就 绪 ， 我 们 运行 CriminalImntent 心 用 。 应 用 不 再 月 瀑 
了 。 如 果 没 有 其 他 问题 ， 你 会 看 到 来 上 自 模拟 器 数据 库 里 的 crime 人 造 数 
据 ， 如 图 11-8 所 示 。 
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图 11-8 来 目 数 据 库 的 crime 数 据 


下 一 章 ， 我 们 会 关联 crime 列 表 项 界面 和 crime 明 细 界 面 ， 用户 点 击 某 个 
crime 列 表 项 ， 就 会 弹出 一 个 crime 明 细 界 面 。 


11.8 HRAJ: 解决 Schema 警告 


如 果 仔 细 翻 查 项 目的 构建 日 志 ， 你 会 看 到 一 条 警告 说 应 用 没有 提供 
schema 导 出 目录 : 


warning: Schema export directory is not provided to the annotation processo 


so we cannot export the schema. You can either provide ~room.schemaLocation 
annotation processor argument OR set exportSchema to false. 


数据 库 schema 就 是 数据 库 结构 ， 其 包含 的 主要 元 素 有 : 数据 库 里 有 哪些 


数据 表 、 这 些 表 里 有 哪些 栏 位 ， 以 及 数据 表 之 间 的 关系 和 约束 是 什么 。 
Room 文 持 导出 数据 库 schema 到 一 个 文件 。 这 很 有 用 ， 因 为 你 可 以 把 它 
保存 在 版 本 控制 系统 中 进行 版 本 历史 控制 。 


以 上 警告 表明 ， 你 需要 提供 一 个 文件 保存 位 置 让 Room 保存 数据 库 
schema。 要 消除 它 ， 有 两 种 方法 : 给 @Database 注 解 提 供 schema 文 件 保 
存 位 置 ， 或 者 禁用 导出 功能 。 请 任 选 一 种 方法 来 消除 schema 导 出 警告 。 


要 提供 schema 文 件 导出 位 置 ， 你 可 以 提供 文件 路 径 给 注解 处 理 器 的 
room.schemaLocation 属 性 。 具 体 做 法 是 在 app/build.gradle 文 件 里 添加 
以 下 kapt{} 代 码 块 : 


android { 


buildTypes { 


} 
kapt { 
arguments { 
arg("room.schemaLocation", "some/path/goes/here/") 


要 禁用 schema 导 出 功能 ， 可 以 将 exportSchema 设 置 为 false: 


@Database(entities = [ Crime::class ], version=1, exportSchema = false) 
@TypeConverters(CrimeTypeConverters: :class) 
abstract class CrimeDatabase : RoomDatabase() { 


abstract fun crimeDao(): CrimeDao 


} 


11.9 深入 学 习 : Fpl 


在 Android 开 发 实践 中 ， 经 常会 用 到 CrimeRepository 中 使 用 过 的 单 例 
然而 ， 单 例 若 使 用 不 当 ， 会 导致 应 用 难以 维护 ， 因 此 它 也 常 遭 人 
Vri?W o 


Android 开 发 常用 单 例 的 一 大 原因 是 ， 它 们 比 fragment 或 activity“ 活 得 
久 ”。 例 如 ， 在 设备 旋转 或 是 在 fragment 和 activity 间 跳 转 的 场景 下 ， 单 例 
依然 还 在 ， 而 旧 的 fragment 或 activity 已 经 不 复 存 在 了 。 


单 例 还 能 方便 地 存储 和 控制 模型 对 象 。 假 设 有 一 个 比 CriminalIntent 更 为 
复杂 的 应 用 ， 它 的 许多 个 activity 和 fragment 会 修改 crime 数 据 。 某 个 控制 
Ens 了 crime 数 据 之 后 ， 怎 么 保证 发 送 给 其 他 控制 单元 的 是 最 新 数 
FEIE? 


如 果 CrimeRepository 掌 控 数 据 对 象 ， 所 有 的 修改 都 由 它 来 处 理 ， 那 
么 是 不 是 控制 数据 的 一 致 性 就 容易 多 了 ? 而 且 ， 在 控制 单元 间 流 转 时 ， 
你 还 可 以 给 每 个 crime 添 加 ID 标识 ， 让 控制 单元 使 用 ID 标识 从 
CrimeRepository 获 取 完 整 的 crime 数 据 。 


当然 ， 单 例 也 有 人 缺点。 虽然 单 例 能 存储 数据 ,“ 活 得 ?也 比 控制 单元 久 ， 
但 这 并 不 代表 它 能 永存 。 在 我 们 切换 至 其 他 应 用 时 ，Android 会 在 茶 个 
时 刻 回 收 内 存 ， 单 例 连 同 那些 实例 变量 也 就 不 复 存在 了 。 结 论 很 明显 : 
单 例 不 适合 做 持久 存储 。《〈 将 文件 写 入 磁盘 或 是 发 送 到 Web 服 务 器 是 很 
好 的 数据 持久 化 存储 方案 。) 


单 例 还 不 利于 单元 测试 (单元 测试 的 更 多 信息 参见 第 20 章 ) 。 例 如 ， 如 
果 应 用 代码 直接 调用 CrimeRepository 对 象 的 静态 函数 ， 测 试 时 以 模 
拟 版 本 的 CrimeRepository 人 代替 实际 的 CrimeRepository 实 例 就 不 太 
现实 。 实 践 中 ，Android 开 发 人 员 会 使 用 依赖 注入 依赖 注入 的 更 多 信 
息 参 见 24.8 节 ) 工具 解决 这 个 问题 。 这 个 工具 允许 以 单 例 模 式 使 用 对 
象 ， 对 象 也 可 以 按 需 替换 。 


使 用 单 例 很 方便 ， 因 而 它 很 容易 被 滥用 。 在 想 用 就 用 、 想 存 就 存 之 前 ， 
希望 你 能 深思 熟 虑 : 


数据 完 竟 用 在 哪里 ? 在 哪里 能 真正 解决 问题 ? 

假如 不 慎重 对 待 这 个 问题 ， 很 可 能 后 来 人 在 但 看 你 的 单 例 代码 时 ， 残 像 
打开 了 一 个 乱糟糟 的 废品 抽 屋 ， 里 面 堆 满 了 废 电池 、 拉 链 扣 、 旧 照片 
等 物品 。 它 们 有 什么 存在 的 意义 ? 再 强调 一 次 : 请 确保 有 充足 的 理由 
使 用 单 例 模 式 存储 你 的 共享 数据 ! 


右 使 用 得 当 ， 单 例 就 是 架构 优秀 的 Android 应 用 中 的 关键 部 件 。 


第 12 章 Fragment Navigation 


本 章 ， 我 们 将 关联 CriminalIntent 应 用 的 列表 与 明细 部 分 。 用 户 点 击 某 个 
crime 列 表 项 时 ，MainActivity 会 使 用 一 个 CrimeFragment 新 实例 来 蔡 
换 CrimeListFragment。CrimeFragment 会 展现 用 户 所 选 Crime 实 例 的 
明细 信息 ， 如 图 12-1 所 示 。 
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图 12-1 用 CrimeFragment 蔡 换 CrimeListFragment 


要 完成 上 述 目 标 ， 你 需要 学 习 如 何 通 过 托管 activity 啊 应 用 户 操作 交换 显 
示 不 同 的 fragment， 以 实现 用 户 界 面 导 航 。 你 还 要 学 习 如 何 使 用 
fragment argument 把 数据 传递 给 fragment 实 例 ， 以 及 如 何 使 用 LiveData 
transformation! MURR RE MDN EA a RE Ki o 


12.1 *#¥ Activity% Fragment 


在 GeoQuiz 应 用 里 ， 要 切换 用 户 界 面 ， 我 们 要 让 一 个 

activity (MainActivity) 局 动 另 一 个 activity (CheatActivity) 。 在 
CriminalIntent 应 用 里 ， 我 们 换个 方式 : 采用 单 activity 多 fragment 架 构 。 
在 采用 这 种 架构 的 应 用 里 ，activity 只 有 一 个 ，fragment 则 有 多 个 ， 其 中 
activity 责 任 重 大 ， 负 责 啊 应 用 户 事 件 ， 交 人 蔡 使 用 各 个 fragment。 


要 实现 从 CrimeListFragment 到 CrimeFragment 的 页 面 导航 ， 你 可 能 
会 想到 利用 托管 activity 的 fragment 管 理 器 发 起 一 个 fragment 事 务 来 处 
理 。 具 体 来 讲 ， 就 是 在 CrimeListFragment 的 
CrimeHolder.onClick(View) 函 数 里 ， 首 先 取 到 MainActivity 的 
FragmentManager， 人 然后 提交 一 个 以 CrimeFragment 蔡 

换 CrimeListFragment 的 事务 。 


之 后 ， 你 在 CrimeListFragment.CrimeHolder 里 写 下 了 如 下 代码 : 


fun onClick(view: View) { 
val fragment = CrimeFragment.newInstance(crime.id) 
val fm = activity.supportFragmentManager 


fm.beginTransaction() 
.replace(R.id.fragment container, fragment) 
.Commit() 


没 错 ， 这 行 得 通 ， 但 有 经 验 的 Android 程 序 员 都 不 会 这 么 做 。Fragment 生 
来 束 是 一 种 可 组 装 的 独立 部 件 。 如 果 你 编写 出 一 个 fragment， 让 它 问 托 
管 activity 的 FragmentManager 添 加 其 他 fragment， 那 这 个 fragment 吏 得 
知道 托管 activity 是 如 何 工 作 的 ， 它 也 束 不 再 是 一 个 可 组 装 的 独立 部 件 
ie 


例如 ， 在 上 面 的 代码 中 ，CrimeListFragment 把 CrimeFragment 添 加 
给 了 MainActivity。 这 样 做 显然 要 有 一 个 前 提 : CrimeListFragment 
认为 MainActivity 的 布局 里 会 有 一 个 fragment_container。 但 我 们 
知道 ， 这 是 CrimeListFragment 的 托管 activity 该 做 的 事 。 


为 维护 fragment 的 独立 性 ， 我 们 将 在 fragment 里 面 定义 回调 接口 ， 把 不 
该 它 做 的 事 都 交 给 它 的 托管 activity 来 做 。 也 就 是 说 ， 像 管理 调度 
fragment 以 及 决定 布局 依赖 关系 这 样 的 任务 ， 就 让 托管 activity 通 过 实现 
回调 接口 去 完成 。 


12.1.1 Fragment] iÑ z HO 


要 代理 任务 给 托管 activity， 被 托管 的 fragment 就 要 定义 一 个 名 

为 Callbacks 的 自 定义 回调 接口 。 这 个 接口 里 定义 的 就 是 被 托管 的 
fragment 要 求 它 的 托管 activity 做 的 工作 。 对 于 这 样 的 fragment， 谁 托管 
它 ， 谁 就 得 实现 它 定义 的 接口 。 


有 了 这 样 的 回调 接口 ，fragment 束 能 调用 托管 activity 的 函数 了 。 至 于 是 
什么 样 的 activity 在 托管 它 ， 它 没 必 要 知道 。 


下 面 就 来 定义 这 样 一 个 回调 接口 ， 把 CrimeListFragment 界 面 的 点 击 
事件 代理 给 它 的 托管 activity。 首 先 ， 打 开 CrimeListFragmentkt 文 件 ， 定 
义 只 有 一 个 回调 函数 的 Callbacks 接 口 。 再 添加 一 个 callbacks 属 性 用 
来 保存 实现 Callbacks 接 口 的 对 象 。 最 后 ， 履 盖 onAttach(Context ) 
和 onDetach() 函 数 以 设置 和 取消 callbacks 属 性 ， 如 代码 清单 12-1 所 
示 。 


代码 清单 12-1 添加 callback 接 口 (CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


/** 
* Required interface for hosting activities 
*/ 
interface Callbacks { 
fun onCrimeSelected(crimeId: UUID) 
} 


private var callbacks: Callbacks? = null 


private lateinit var crimeRecyclerView: RecyclerView 

private var adapter: CrimeAdapter = CrimeAdapter(emptyList() ) 

private val crimeListViewModel: CrimeListViewModel by lazy { 
ViewModelProviders.of(this).get(CrimeListViewModel::class.java) 


j 
override fun onAttach(context: Context) { 
super.onAttach(context) 


callbacks = context as Callbacks? 


j 

override fun onCreateView( 

): View? ( 

l dus 

override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 
} 

override fun onDetach() { 


super .onDetach() 
callbacks = null 


当 fragment 附 加 到 activity 时 ， 会 调用 Fragment .onAttach(Context) 生 
命 周期 函数 。 这 里 ， 我 们 把 传 给 onAttach(. . . ) 的 Context 值 参 保 存 
到 callbacks 属 性 里 。 既然 CrimeListFragment 是 由 一 个 activity 托 管 
着 的 ， 那 么 传 给 onAttach(.. .) 的 Context 对 象 就 是 托管 它 的 activity 实 
例 。 


之 前 说 过 ，Activity 是 Context 的 子 类 ， 显 然 ，onAttach(. ..) 函 数 

使 用 Context 做 参数 会 更 合适 且 更 安全 。 因 为 对 于 onAttach(...) 疯 数 
来 说 ，onAttach(Activity) 函 数 签名 版 已 被 废弃 ， 说 不 定 就 会 在 未 来 
版 本 的 API 中 被 删除 。 


与 Fragment.onAttach(Context) 函 数 相 呼应 ， 

在 Fragment .onDetach() 这 个 没落 生命 周期 函数 里 ， 我 们 把 
callbacks 属 性 值 设置 为 nul1。 之 所 以 这 么 做 ， 是 因为 fragment 随 后 束 
要 和 它 的 托管 activity“ 说 再 见 ” 了 。 


注意 ，CrimeListFragment 做 了 一 个 未 经 检查 的 类 型 转换 ， 把 它 的 托 
管 activity 转 成 了 CrimeListFragment.callbacks。 这 样 一 来 ， 托 管 
activity 就 必须 要 实现 CrimeListFragment.callbacks 接 口 了 。 


现在 ，CrimeListFragment 有 办 法 调用 其 托管 activity 的 函数 了 。 至 于 
托管 activity 是 谁 并 不 重要 ， 只 要 它 实现 
CrimeListFragment.callbacks 接 口 ，CrimeListFragment 都 一 样 工 
(Es 


接 下 来 ， 如 代码 清单 12-2 所 示 ， 在 CrimeHolder.onClick(View) 函 数 
里 ， 调 用 callbacks 接 口 的 onCrimeSelected(Crime) 函 数 ， 响 应 用 户 
点 击 crime 列 表 项 事件 。 


代码 清单 12-2 调用 callbacks (CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


private inner class CrimeHolder(view: View) 
: RecyclerView.ViewHolder(view), View.OnClickListener { 


fun bind(crime: Crime) ( 


} 


override fun onClick(v: View?) { 


最 后 ， 如 代码 清单 12-3 所 示 ， 更 新 MainActivity， 先 
在 onCrimeSelected(UUID) 里 打印 调试 日 志 ， 以 此 实现 
CrimeListFragment.callbacks 接 口 。 


代码 清单 12-3 ”实现 callbacks 接 口 (MainActivity.kt) 


private const val TAG = "MainActivity" 
class MainActivity : AppCompatActivity(), 
CrimeListFragment.Callbacks { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


override fun onCrimeSelected(crimeId: UUID) ( 
Log.d(TAG, "MainActivity.onCrimeSelected: $crimeId") 
} 


i517 CriminalIntent A. FRA BA YELogcet AA AMainActivitylW H 
S UK. 在 crime 列 表 项 界面 ， 每 点 一 条 crime 记 录 ， 就 能 看 到 Logcat 窗 
FSF AA. 这 表明 ; 通过 
Callbacks.onCrimeSelected(UUID)， 点 击 事件 从 
CrimeListFragment 传 递 到 了 MainActivity。 


12.1.2 fragment 


搞定 了 回调 接口 ， | 
函数 。 用 户 只 要 在 CrimeListFragment 界 面 点 击 某 一 条 crime 记 录 ， 就 
用 CrimeFragment 实 例 蔡 换 CrimeListFragment (crimeld H E] 56 
WE) ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4 HjCrimeFragment 
换 CrimeListFragment (MainActivity.kt) 


class MainActivity : AppCompatActivity(), 
CrimeListFragment.Callbacks { 


override fun onCreate(savedInstanceState: Bundle?) ( 


} 


override fun onCrimeSelected(crimeId: UUID) ( 


val fragment = CrimeFragment() 
supportFragmentManager 
.beginTransaction() 
.replace(R.id.fragment container, fragment) 
. commit () 


使 用 新 提供 的 fragment，FragmentTransaction.replace(Int， 
Fragment) 蔡 换 了 MainActivity 托 管 的 fragment (在 指定 资源 ID 的 容器 
E) 。 如 果 指 定 容器 里 没有 fragment， 那 就 添加 一 个 新 的 fragment， 这 
相当 于 调用 了 FragmentTransaction.add(Int，fragment) 函 数 。 


再 次 运行 CriminalIntent 应 用 。 在 crime 列 表 项 界面 点 击 任 一 记录 ， 你 应 该 
能 看 到 如 图 12-2 所 示 的 crime 明 细 界 面 弹出 。 
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图 12-2 ”空空 的 CrimeFragment 


因为 没有 告诉 CrimeFragment 该 显示 哪 条 crime 记 录 ， 所 以 crime 明 细 界 
面 空空 如 也 。 稍 后 我 们 会 填充 数据 。 当 务 之 急 ， 页 面 导航 实现 还 有 一 个 
[SUE E ER 


按 回 退 键 ， 整 个 应 用 界面 退出 了 。 这 是 因为 启动 应 用 
后 ，MainActivity 是 应 用 回 退 栈 里 唯一 一 个 实例 。 


显然 ， 通 过 按 回 退 键 ， 用 户 期 望 从 crime 明 细 界 面 回 到 crime 列 表 项 界 
面 。 要 实现 这 个 效果 ， 需 要 把 蔡 换 事务 添加 到 回 退 栈 里 ， 如 代码 清单 
12-5 所 示 。 


代码 清单 12-5 ”把 fragment 事 务 添加 到 回 退 栈 (MainActivity.kt) 


class MainActivity : AppCompatActivity(), 
CrimeListFragment.Callbacks { 


override fun onCrimeSelected(crimeId: UUID) ( 
val fragment - CrimeFragment() 
supportFragmentManager 


.beginTransaction() 

.Peplace(R.id.fragment container, fragment) 
.addToBackStack(null) 

. commit() 


把 一 个 事务 添加 到 回 退 栈 后 ， 在 用 户 按 回 退 键 时 ， 事 务 会 回 滚 。 因 此 ， 
在 这 种 情况 下 ，CrimeFragment 又 被 蔡 换 回 了 CrimeListFragment。 


如 有 果 想 给 回 退 栈 状态 取 个 名 字 ， 可 以 将 一 个 String 传 给 
FragmentTransaction.addToBackStack(String) 函 数 。 这 样 做 是 可 
选 的 ， 并 且 ， 由 于 有 没有 名 字 无 所 谓 ， 因 此 你 传 入 了 nu11。 


运行 CriminalIntent 应 用 。 点 选 crime 列 表 项 里 任 一 记录 启动 
CrimeFragment 界 面 。 按 回 退 键 又 回 到 CrimeListFragment 界 面 。 页 
面 导航 终于 符合 用 户 预 期 了 。 


12.2 Fragment argument 


现在 ， 用 户 点 击 某 个 crime 列 表 项 ，CrimeListFragment 就 能 通知 其 托 
管 activity (MainActivity) ， 并 传 入 所 选 crime 记 录 的 ID。 


这 虽然 很 棒 ， 但 我 们 真正 需要 的 是 如 何 从 MainActivity 传 递 crime ID 给 
CrimeFragment。 这 样 ，CrimeFragment 就 能 用 从 数据 库 取 到 的 对 应 
crime 数 据 填 充 UI 了 。 


这 个 问题 可 以 用 Fragment argument 来 解决 。 有 了 Fragment argument， 你 
就 可 以 把 一 段 数 据 保存 在 属于 fragment 的 “ 某 个 地 方 "””。 这 个 专属 于 
fragment 的 地 方 实际 指 的 是 它 的 argument bundle, PHEW GES 
activity 或 其 他 对 象 ) ，fragment 目 己 就 能 从 argument bundle 取 到 保存 数 
据 。 


Fragment argument 可 以 帮 你 把 一 个 fragment 很 好 地 封装 起 来 。 封 装 民 好 
的 fragment 就 是 一 个 可 复 用 的 构建 单元 ， 可 以 交 给 任何 activity 托 管 。 


要 创建 Fragment argument， 需 要 先 创 建 Bbundle 对 象 。Bundle 包 含 键 值 
对 ， 我 们 可 以 像 附 加 extra 到 Activity 的 intent 中 那样 使 用 它 。 一 个 键 值 
对 即 一 个 argument。 然 后 ， 使 用 Bundle 限 定 类 型 的 put 函 数 〈 类 似 于 
Intent 函 数 ) ， 将 argument 添 加 到 bundle 中 : 


val args = Bundle().apply { 
putSerializable(ARG_MY_OBJECT, myObject) 


putInt(ARG MY INT, myInt) 
putCharSequence(ARG MY STRING, myString) 
} 


每 个 fragment 实 例 都 可 以 附带 一 个 fragment argument Bundlext &. 


12.2.1 将 argument 附 加 到 fragment 


要 将 argument bundle 附 加 到 某 个 fragment， 你 需要 调 
用 Fragment .setArguments(Bundle) 函 数 。 而 且 ， 还 必须 在 这 个 
fragment 创 建 后 、 添 加 给 某 个 activity 前 完成 。 


为 满足 上 述 要 求 ，Android 开 发 人 员 采 取 的 习惯 做 法 是 : 添加 一 个 包 
含 newInstance(...) 函 数 的 伴生 对 象 给 Fragment 类 。 使 

用 newInstance(...) 函 数 ， 你 可 以 创建 fragment 实 例 及 Bundle 对 象 ， 
然后 再 设置 其 argument。 


托管 activity 需 要 某 个 fragment 实 例 时 ， 我 们 让 它 转 去 调 

用 newInstance(...) 函 数 ， 而 不 是 直接 调用 其 构造 函数 。 而 且 ， 为 满 
足 fragment 创 建 其 argument 的 需求 ，activity 可 以 给 newInstance(...) 函 
数 传 入 任何 需要 的 参数 。 


在 CrimeFragment 类 中 ， 编 写 可 以 接受 UUID 参 数 的 
newInstance(UUID) 函 数 ， 创 建 一 个 argument bundle 和 一 个 fragment 实 
例 ， 然 后 把 新 建 argument 附 加 给 fragment 实 例 ， 如 代码 清单 12-6 所 示 。 


代码 清单 12-6 ”编写 newInstance(UUID) 函 数 
( CrimeFragment.kt) 


private const val ARG CRIME ID = "crime id" 


class CrimeFragment : Fragment() { 


override fun onStart() { 


} 


companion object { 


fun newInstance(crimeId: UUID): CrimeFragment { 
val args = Bundle().apply { 
putSerializable(ARG CRIME ID, crimeId) 
} 
return CrimeFragment().apply { 
arguments = args 


现在 ， 要 创建 CrimeFragment，MainActivity 应 该 调 

用 CrimeFragment.newInstance(UUID) 函 数 ， 并 传 入 从 
MainActivity.onCrimeSelected(UUID) 获 取 的 UUID 参 数值 ， 如 代码 
清单 12-7 所 示 。 


代码 清单 12-7 fEHjCrimeFragment.newInstance(UUID) RK Zi 
(MainActivity.kt) 


class MainActivity : AppCompatActivity(), 


CrimeListFragment.Callbacks { 


override fun onCrimeSelected(crimeId: UUID) ( 


— —wvai—fragment—-—CrimeFragment(Ó) 


val fragment - CrimeFragment.newInstance(crimeId) 
supportFragmentManager 
.beginTransaction() 
.Peplace(R.id.fragment container, fragment) 
.addToBackStack(null) 
. commit() 


注意 ，activity 和 fragment 不 需要 也 无 法 同时 相互 保持 独 

立 。MainActivity 必 须 了 解 CrimeFragment 的 内 部 细节 ， 比 如 知道 它 
内 部 有 个 newInstance(UUID) 函 数 。 这 很 正常 。 托 管 activity 应 该 知道 

这 些 细 节 ， 以 便 托 管 fragment， 但 fragment 不 需要 知道 其 托管 activity 的 

细节 问题 ， 至 少 在 需要 保持 fragment 独 立 的 时 候 应 该 如 此 。 


12.2.2 ”获取 argument 
当 fragment 需 要 获取 它 的 argument 时 ， 会 先 读 取 Fragment 类 的 


arguments 属 性 ， 再 调用 Bundle 限 定 类 型 的 get 函 数 ， 比 如 
getSerializable(...). 


=] #|CrimeFragment.onCreate(...) Mat, A fragmentlf] 
argument 中 获取 UUID。 另 外 再 日 志和 输出 crimne ID， 确 认 argument 附 加 没 
问题 ， 如 代码 清单 12-8 所 示 。 


代码 清单 12-8 从 argument 中 获取 crime ID (CrimeFragment.kt) 


private const val TAG = "CrimeFragment" 
private const val ARG CRIME ID = "crime id" 


class CrimeFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
crime = Crime() 


val crimeId: UUID = arguments?.getSerializable(ARG CRIME ID) as UUI 
Log.d(TAG, "args bundle crime ID: $crimeId") 
// Eventually, load crime from database 


运行 CriminalIntent 应 用 。 虽 然 运 行 结果 一 样 ， 但 你 应 该 由 囊 地 感到 高 
兴 ， 因 为 CrimeFragment 不 仅 取 到 了 Crime ID， 而 且 也 变 得 更 通用 了 。 


12.3 ”使 用 LiveData 数 据 转 换 


^H f crime ID 之 后 ，CrimeFragment 需 要 从 数据 库 里 取出 对 应 crime 对 象 
在 页 面 上 显示 。 既 然 需 要 数据 库 碍 询 ， 你 也 不 想 因 设备 旋转 而 重复 去 数 
据 库 查找 数据 ， 那 就 需要 添加 一 个 CrimeDetailViewModel 来 管理 数据 
库 查 询 。 


这 样 ， 当 CrimeFragment 需 要 显示 给 定 ID 的 crime 数 据 时 ， 它 的 
CrimeDetailViewMode1 就 应 该 发 起 getCrime(UUID ) 数 据 库 查 询 请 
求 。 拿 到 数据 后 ，CrimeDetailViewMode1 还 应 该 告知 
CrimeFragment， 并 把 查 来 的 Crime 数据 传 给 它 。 


创建 一 个 名 为 CrimeDetailViewModel1 的 新 类 ， 对 外 暴露 一 

个 LiveData 必 性 来 存储 和 发 布 从 数据 库 取 出 的 crime 数 据 。 再 使 
HjLiveDataSzH—432 48: crime ID 一 变 就 触发 新 的 数据 库 查 询 ， 如 代 
码 清单 12-9 所 示 。 


代码 清单 12-9 ACrimeFragmentis 
JliViewModel (CrimeDetailViewModel.kt) 


class CrimeDetailViewModel() : ViewModel() { 


private val crimeRepository 
private val crimeIdLiveData 


= CrimeRepository.get() 
= MutableLiveData<UUID>() 
var crimeLiveData: LiveData<Crime?> = 
Transformations.switchMap(crimeIdLiveData) { crimeId -> 
crimeRepository.getCrime(crimeId) 


} 


fun loadCrime(crimeId: UUID) { 
crimeIdLiveData. value = crimeId 


} 


在 上 述 代 码 中 ，crimeRepository 属 性 引用 着 CrimeRepository。 你 
不 一 定 需 要 这 么 做 ,但 后 面 CrimeDetailViewModel 和 
CrimeRepository 在 多 个 地 方 会 有 交互 ， 因 而 这 个 属性 之 后 会 有 用 。 


crimeIdLiveData 保 存 着 CrimeFragment 当 前 显示 (或 将 要 显示 ) 的 
crime 对 象 的 ID。CrimeDetailViewMode1l1 刚 创建 时 ， 这 个 crime ID 还 没 
有 设置 。 但 最 终 ，CrimeFragment 会 调 
HjCrimeDetailViewModel.loadCrime (UUID) 以 让 ViewModel 知 道 该 
加 载 哪个 crime 对 象 。 


注意 ， 我 们 明确 地 把 crimeLiveData 的 类 型 定义 为 LiveData<Crime? 
>。 既 然 crimeLiveData 是 对 外 烘 圳 的， 你 就 应 该 确保 它 对 外 其 露 的 不 
是 MutableLiveData。 一 般 来 讨 ，ViewModel 从 不 应 该 对 外 暴 

露 MutablelLiveData。 


你 可 能 觉得 奇怪 ， 既 然 crime ID 归 CrimeDetailViewModel 私 有 ， 这 里 
为 什么 把 crime ID 封 装 在 LiveData 里 。CrimeDetailViewModel 里 有 谁 
要 侦 听 私有 ID 的 变化 呢 ? 


答案 就 在 LiveData 的 Transformation 语 句 中 。LiveData 数 据 转 换 
(live data transformation) 是 设置 两 个 LiveData 对 象 之 间 触 发 和 反馈 关 
系 的 一 个 解决 办 法 。 一 个 数据 转换 函数 需要 两 个 参数 : 一 个 用 作 触 发 器 
(trigger) 的 LiveData 对 象 ， 一 个 返回 LiveData 对 象 的 映射 函数 
(mapping function) 。 数 据 转换 函数 会 返回 一 个 数据 转换 结果 
(transformation result) 一 一 其 实 就 是 一 个 新 LiveData 对 象 。 每 次 只 要 
触发 器 LiveData 有 新 值 设置 ， 数 据 转换 函数 返回 的 新 LiveData 对 象 的 
值 束 会 得 到 更 新 。 


数据 转换 结果 的 值 要 靠 执 行 映射 函数 算出 。 从 映射 函数 返回 的 
LiveData 的 value 属 性 会 被 用 来 设置 数据 转换 结果 (新 LiveData 对 
象 ) 的 value 属 性 。 


这 样 使 用 数据 转换 意味 着 CrimeFragment 只 需 观察 
CrimeDetailViewModel.crimeLiveData—ix. “4CrimeFragment Œ 


改 了 要 显示 crime 记 录 的 ID，CrimeDetailViewMode1 就 会 把 新 的 crime 
数据 发 布 给 LiveData 数 据 流 。 


打开 CrimeFragment.kt 文 件 ， 关 联 CrimeFragment 和 
CrimeDetailViewModel. ikCrimeDetailViewModel 


在 onCreate(...) 函 数 里 加 载 crime 对 象 ， 如 代码 清单 12-10 所 示 。 


代码 清单 12-10 关联 CrimeFragment 和 和 
CrimeDetailViewModel (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 
private lateinit var crime: Crime 


private lateinit var solvedCheckBox: CheckBox 
private val crimeDetailViewModel: CrimeDetailViewModel by lazy { 
ViewModelProviders.of(this).get(CrimeDetailViewModel: :class. java) 


) 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate(savedInstanceState) 
crime - Crime() 


val crimeId: UUID = arguments?.getSerializable(ARG CRIME ID) as UUI 


下 一 步 ， 观 察 CrimeDetai1lViewMode1l 的 crimeLiveData， 一 有 新 数据 
发 布 就 更 新 UI， 如 代码 清单 12-11 所 示 。 


代码 清单 12-11 观察 数据 变化 〈CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var crime: Crime 


override fun onCreateView( 
): View? { 
j 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 
super.onViewCreated(view, savedInstanceState) 
crimeDetailViewModel.crimeLiveData.observe( 
viewLifecycleOwner, 
Observer ( crime -> 
crime?.let { 
this.crime - crime 
updateUI() 
} 
}) 
} 


override fun onStart() { 


} 


private fun updateUI() { 
titleField.setText(crime.title) 
dateButton.text = crime.date.toString() 
solvedCheckBox.isChecked = crime.isSolved 


AAA JS androidx.lifecycle.Observer. ) 


你 也 许 注意 到 了 ，CrimeFragment 自 己 的 Crime 状 态 是 保存 在 它 的 
crime 属 性 里 的 。 这 个 crime 属 性 里 的 值 就 是 用 户 当 前 所 做 的 编辑 。 

而 CrimeDetailViewModel.crimeLiveData 里 的 crime 数 据 是 当前 保存 
在 数据 库 里 的 数据 。CrimeFragment 在 进入 停止 状态 时 ， 会 发 布 用 户 编 
辑 数据 一 一 把 数据 更 新 写 入 数据 库 。 


运行 CriminalIntent 应 用 。 点 击 列表 项 里 任 一 crime 记 录 。 如 果 没 有 其 他 问 
题 ， 你 会 看 到 crime 明 细 界 面 出 现 了 ， 页 面 上 显示 的 正 是 对 应 crime 记 录 
的 数据 ， 如 图 12-3 所 示 。 
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图 12-3 “CriminalIntent 应 用 的 回 退 栈 


CrimeFragment 页 面 跳出 时 ， 如 果 页 面 显示 的 crime 记 录 处 于 已 解决 状 
态 ， 那 么 你 会 看 到 义 选 框 被 勾 选 的 动画 。 这 个 现象 是 正常 的 ， 因 为 勾 选 
框 被 勾 选 是 一 个 异步 操作 的 2 BR. HP HB sICPimeFragmentij 待 
显示 crime 对 象 的 数据 库 查 询 也 在 进行 。 数 据 库 查 询 结 
R, a 的 crimeDetailViewModel.crimeLiveData 数 据 观察 者 
会 得 到 通知 ， 它 随即 就 更 新 了 部 件 上 要 显示 的 数据 。 


为 了 跳 过 checkbox 的 勾 先 动画， 我们 改 用 代码 的 方式 设置 义 选 框 的 义 选 

状态 。 这 需要 调用 View.JjumpDrawablesToCurrentSstate() 函 数 来 实 

现 。 注 意 ， 根 据 应 用 需要 ， 如 果 crime 明 细 界 面 加载 数 据 滞后 严重 ， 你 

可 以 考虑 提前 预 加 载 crime 数 据 到 内 存 里 〈 例 如 ， paca seca 把 

它 保 存在 某 个 共享 位 置 。 人 至 于 CriminalIntent 应 用 ， 一 点 ) 点 点 数据 加 载 沸 后 

和 影响， 选择 直接 跳 过 勾 选 框 义 选 动画 就 够 了 ， 如 代码 清单 12- 12 
示 。 


代码 清单 12-12” 跳 过 checkbox 动 画 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private fun updateUI() ( 
titleField.setText(crime.title) 
dateButton.text - crime.date.toString() 


— ——selvedCheckBex--isChecked—-—crime-isSolved 
solvedCheckBox.apply { 
isChecked = crime.isSolved 
jumpDrawablesToCurrentState( ) 


再 次 运行 CriminalIntent 应 用 。 选 择 某 个 已 解决 crime 项 。 可 以 看 到 ， 明 细 
页 面 跳出 时 ， 勾 选 框 勺 选 动 画 没 有 了 。 手 动 清除 再 勺 选 ， 动 画 又 出 现 
了 。 这 就 是 我 们 想 要 的 结果 。 


现在 ， 编 辑 crime 记 录 标 题 。 然 后 按 回 退 键 回 到 crime 列 表 项 界面 。 很 不 
幸 ， 你 刚 做 的 修改 没有 保存 下 来 。 幸 运 的 是 ， 这 个 问题 很 好 解决 。 


12.4 更 新 数据 库 


crime 数 据 只 能 保存 在 数据 库 里 。 在 CriminalImmtent 必 用 里 ， 用 户 离开 

crime 明 细 页 面 时 ， 他 们 所 做 的 任何 修改 都 应 及 时 存 入 数据 库 。 CAS Tn] 

eae 同 的 需求 ， 比 如 添加 一 个 “save” 按 钮 ， 或 用 户 边 输入 边 保 
Fo ) 


首先 ， 打 开 CrimeDao.kt 文 件 ， 添 加 一 个 函数 更 新 现 有 crime 数 据 。 顺 便 
再 添加 一 个 插入 新 crime 数 据 的 函数 (添加 创建 新 crime 记 录 呈 单项 之 后 
使 用 ， 详 见 第 14 章 ) ， 如 代码 清单 12-13 所 示 。 


代码 清单 12-13 ”添加 数据 更 新 和 插入 函数 
(database/CrimeDao.kt) 


@Dao 
interface CrimeDao { 


@Query("SELECT * FROM crime") 
fun getCrimes(): LiveData<List<Crime>> 


@Query("SELECT * FROM crime WHERE id=(:id)") 
fun getCrime(id: UUID): LiveData<Crime?> 


@Update 
fun updateCrime(crime: Crime) 


@Insert 
fun addCrime(crime: Crime) 


新 增 函 数 使 用 的 注解 不 需要 任何 参数 。Room 会 使 用 它们 产生 合适 的 
SQL 操作 命令 。 


updateCrime() 函 数 使 用 @Update 注 解 。 根 据 传 入 的 crime 对 象 的 ID， 
该 函数 首先 找到 数据 库 里 的 对 应 记录 ， 然 后 使 用 新 数据 更 新 它 。 


addCrime() 函 数 使 用 @Insert 注 解 。 传 入 该 函数 的 crime 参 数 克 是 要 写 入 
数据 库 的 数据 。 


接 下 来 ， 就 是 更 新 CrimeRepository， 调 用 刚 添加 的 插入 和 更 新 DAO 池 
数 。 回 忆 之 前 章节 ， 我 们 知道 ，CrimeDao.getCrimes() 和 
CrimeDao.getCrime(UUID) 这 两 个 DA0 函 数 返回 的 是 LiveData， 因 此 
Room 会 在 后 台 线 程 上 自动 执行 它们 的 数据 库 查 询 。 而 且 ，LiveData 还 
会 日 动 把 数据 发 回 主 线程 供 你 更 新 UI。 


然而 ， 和 之 前 不 一 样 ，Room 不 会 自动 在 后 台 线 程 上 执行 数据 库 插入 和 
更 新 操作 。 没 办 法 ， 你 只 能 自己 手动 在 后 台 线 程 上 执行 这 些 DAO 调 用 
了 。 具 体 怎么 做 ， 这 里 有 一 个 常用 的 办 法 : 使 用 executor。 


12.4.1 {executor 


Executor 是 一 个 需要 引用 线程 的 对 象 。executor 实 例 有 个 函数 叫 execute， 

a 代码 块 中 的 代码 会 在 executor 实 例 引用 的 线程 上 
行 。 

我 们 来 创建 一 个 使 用 新 线程 〈 只 会 是 后 台 线 程 ) 的 executor 实 例 。 既 然 

代码 块 里 的 代码 都 会 在 新 的 后 台 线 程 上 执行 ， 那 我 们 就 可 以 放心 地 在 上 


面 进 行 数据 库 操作 了 。 


你 不 能 直接 在 CrimeDao 里 实现 一 个 executor， 因 为 Room 会 基于 你 定义 的 
接口 自动 产生 函数 实现 。 所 以 ， 我 们 转 而 在 CrimeRepository 里 实现 它 。 
如 代码 清单 12-14 所 示 ， 添 加 一 个 executor 属 性 引用 Executor 对 象 ， 然 后 
使 用 它 执行 数据 更 新 和 插入 。 


代码 清单 12-14 ”使 用 executor 执 行 数 据 更 新 和 插入 
(CrimeRepository.kt ) 


class CrimeRepository private constructor(context: Context) { 


private val crimeDao 
private val executor 


database. crimeDao() 
Executors.newSingleThreadExecutor() 


getCrimes(): LiveData«List«Crime»» - crimeDao.getCrimes() 
getCrime(id: UUID): LiveData«Crime?» - crimeDao.getCrime(id) 


updateCrime(crime: Crime) ( 
executor.execute { 
crimeDao.updateCrime(crime) 


} 


addCrime(crime: Crime) { 
executor.execute { 
crimeDao.addCrime(crime) 


newSingleThreadExecutor() KARIR [B] — ^P 8 IET ZG FE Hexecutor K 
例 。 使 用 这 个 executor 实 例 执 行 的 工作 都 会 发 生 在 它 指 问 的 后 台 进 程 
Js 


updateCrime() 和 addCrime() 函 数 都 封装 在 execute {} 代 人 码 块 里 。 前 
面 说 过 ， 这 可 以 保证 它们 在 后 台 线 程 上 执行 ， 不 会 阻塞 你 的 UI 刷新 。 


12.4.2 ”数据 库 写 入 与 fragment 生 命 周 期 


更 新 应 用 ， 当 用 户 离开 crime 明 细 页 面 时 ， 将 他 输入 的 值 写 入 数 
jn E o 


打开 CrimeDetailViewModel.kt 文 件 ， 添 加 一 个 函数 把 crime 数 据 写 入 数据 
库 ， 如 代码 清单 12-15 所 示 。 


代码 清单 12-15 ”添加 数据 保存 功能 CCrimeDetailViewModel.kt) 


class CrimeDetailViewModel() : ViewModel() { 


fun loadCrime(crimeId: UUID) { 
crimeIdLiveData.value = crimeId 


} 


fun saveCrime(crime: Crime) { 
crimeRepository.updateCrime(crime) 


} 


上 述 代 码 中 ，saveCrime(Crime) 函 数 接收 传 入 的 Crime 对 象 ， 调 
用 crimeRepository.updateCrime(crime) 函 数 在 后 台 更 新 数据 库 。 


现在 ， 更 新 CrimeFragment， 如 代码 清单 12-16 所 示 ， 把 用 户 编辑 后 的 
数据 写 入 数据 库 。 


代码 清单 12-16 ”在 onStop 里 保存 数据 (CrimeFragment.kt) 


class CrimeFragment : Fragment() { 
override fun onStart() ( 


} 


override fun onStop() ( 
super .onStop() 
crimeDetailViewModel.saveCrime(crime) 


} 


private fun updateUI() { 


À isi 


只 要 fragment 进 入 停止 状态 《在 屏幕 上 完全 看 不 

到 ) ，Fragment .onSstop() 函 数 就 会 被 调用 。 这 里 ， 是 指 用 户 离开 
crime 明 细 页 面 〈 比 如 按 了 回 退 键 》， 数 据 就 会 被 保存 下 来 。 如 果 用 户 
切换 任务 〈 比 如 按 了 Home 键 或 者 使 用 概览 屏 ) ， 用 户 数据 也 会 得 到 保 
存 。 所 以 ， 无 论 是 用 户 离 开 ， 还 是 切换 任务 ， 甚 至 是 因 内 存 不 够 用 进程 
在 onstop() 函 数 中 保存 数据 都 能 保证 用 户 编辑 数据 不 会 丢 


运行 CriminalIntent 应 用 。 任 选 一 条 crime 记 录 ， 启 动 crime 明 细 页 面 做 出 

修改 。 然 后 ， 按 回 退 键 返 回来 欣赏 你 的 成 果 : 所 有 修改 都 生效 了 。 下 一 

i 我 们 会 在 crime 明 细 界 面 添加 日 期 按钮 ， 让 用 户 选 择 crime 事 件 的 友 
日 期 。 


12.5 深入 学 习 : 为 何 要 用 Fragment Argument 


本 章 ， 通 过 给 fragment 类 添加 newInstance(...) 函 数 ， 我 们 在 创建 一 
个 fragment 新 实例 时 把 argument 传 递 了 下 去 。 这 种 模式 方便 你 组 织 代 
码 ， 同 时 就 fragment argument 这 个 例子 来 看 ， 你 只 能 这 么 做 。 因 为 ， 想 
使 用 一 个 构造 函数 束 把 argument 传 给 fragment 实 例 是 不 可 能 的 。 


例如 ， 不 添加 newInstance(UUID) 函 数 ， 你 可 能 想到 直接 添加 一 个 以 

UUID 为 参数 的 构造 函数 给 CrimeFragment。 然 而 这 种 办 法 是 有 人 缺陷 的 。 

我 们 知道 ， 在 设备 配置 改变 时 ， 当 前 activity 的 fragment 管 理 器 会 自动 重 
建 activity 之 前 托管 的 fragment， 然 后 ， 把 新 建 的 fragment 潜 加 给 新 的 


activity。 


设备 配置 改变 后 ，fragment 管 理 器 重建 fragment 时 ， 它 会 默认 调用 
fragment 的 无 参数 构造 函数 。 结 果 就 是 ， 设 备 旋转 后 ， 新 的 fragment 实 
例 就 收 不 到 crime ID 数据 了 。 


这 样 看 来 ， 使 用 fragment argument 有 什么 不 同 吗 ? 即使 fagment 被 销毁 
J, Fragment argument 也 可 以 保存 下 来 。 然 后 ， 在 fragment 管 理 霹 因 设 
备 旋 转 重 建 fragment 时 ， 会 把 原来 保存 的 argument 重 新 附加 给 新 建 
fragment。 这 样 ， 新 建 fragment 就 能 用 它 重 建 自己 的 状态 了 。 


以 上 方案 似乎 都 很 复杂 。 为 什么 不 直接 在 CrimeFragment 里 创建 一 个 实 
例 变量 呢 ? 


创建 实例 变量 的 方式 也 不 可 靠 。 在 操作 系统 重建 fragment 时 《设备 配置 
发 生 改 变 ) 用 户 和 暂时 离开 当前 应 用 《操作 系统 按 需 回收 内 存 ) ， 任 何 实 
例 变量 都 将 不 复 存 在 。 尤 其 是 内 存 不 够 、 操 作 系统 强制 “ 杀 邱 ?应 用 的 情 
况 ， 可 以 说 是 无 人 能 挡 。 


因此 ， 可 以 说 ，fragment argument 就 是 为 应 对 上 述 场景 而 生 。 


还 有 另 一 个 方法 应 对 上 述 场景 ， 那 就 是 使 用 实例 状态 保存 机 制 。 有 具体 来 
说 ， 就 是 将 crime ID 赋值 给 实例 变量 ， 然 后 

在 onSaveInstanceSstate(Bundle) 函 数 中 保存 下 来 。 要 用 时 ， 从 
onCreate(Bundle?) 函 数 的 Bundle 中 取 回 。 


然而 ， 这 种 解决 方案 的 维护 成 本 高 。 举 例 来 说 ， 如 果 你 在 若干 年 后 要 修 
改 fragment 代 人 码 以 添加 其 他 argument， 很 可 能 会 筷 记 
在 onSaveInstanceState(Bundle) 函 数 里 保存 新 增 的 argument。 


Android 开 有 发 人 员 更 喜欢 fragment argument 这 个 解决 方案 ， 因 为 这 种 方式 
很 清楚 直 白 。 知 二 年 后 ， 再 回头 修改 老 代 码 时 ， 一 眼 就 能 看 出 ，crime 
ID 是 以 argument 保 存 和 传递 使 用 的 。 即 使 要 新 增 argument， 也 会 记得 使 
用 argument bundle 保 存 它 。 


12.6 深入 学 习 : Navigation 架 构 组 件 库 


你 已 经 看 到 了 ， 实 现 应 用 内 的 页 面 导航 有 多 重 途 径 。 例 如 ， 创 建 多 个 
activity， 一 个 页 面 对 应 一 个 ， 用 户 与 UI 交互 ， 启 动 它们 。 或 者 创建 一 个 
启动 activity 和 多 个 fragment， 然 后 用 activity 托 管 各 个 UI fragment。 


为 简化 应 用 内 的 导航 ， 作 为 Jetpack 库 的 一 部 分 ，Android 团 队 引 入 了 
Navigation 架 构 组 件 库 。 如 图 12-4 所 示 ， 这 个 新 染 构 库 提供 了 一 个 可 视 
化 编辑 器 ， 能 让 你 轻松 配置 页 面 导 航 流 。 
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图 12-4 SNF at 


如 何 实现 应 用 里 的 页 面 导 航 ，Navigation 库 有 自己 的 坚持 。 相 比 一 个 
activity 一 个 页 面 ， 它 更 倾 癌 于 使 用 单 activity 多 fragment 架 构 。 在 页 面 导 
航 编辑 工具 里 ， 你 可 以 直接 给 fragment 设 置 argument 值 。 


作为 一 次 挑战 ， 请 复制 CriminalIntent 项 目 ， 使 用 Navigation 架 构 组 件 实 
施 应 用 的 页 面 导 航 。 在 实施 过 程 中 ， 碍 阅 文 档 会 非常 有 帮助 。 搭 建 环境 
有 点 复 灯 ， 要 安装 配置 不 少 东 西 。 不 过 ， 六 天 是 值得 的 ， 环 境 搭 好 用 起 
ee eae 然后 把 它们 关联 起 来 就 轻 轻 松 松 实现 了 应 用 
YON S Lo 


本 书 撰 写 时 ， 稳 定 版 的 Navigation 架 构 组 件 才 刚刚 正式 发 布 ， 实 在 没 时 
间 在 本 书 里 应 用 它 了。 但 是 这 个 工具 很 有 前 途 ， 未 来 肯定 会 得 到 开发 者 
们 的 青睐 。 我 们 一 直 在 试用 它 ， 推 荐 你 也 试 试 ， 看 看 是 人 否 有 同样 的 感 

党 。 


12.7 ”挑战 练习 : 实现 高 效 的 RecyclerView 刷 新 


当前 ， 用 户 编辑 完 某 项 crime 信 息 返 回 列表 项 界面 

时 ，CrimeListFragment 会 重 绘 RecyclerView 里 可 见 的 所 有 crime 记 
录 。 显 然 ， 这 页 面 刷 新 效率 太 低 了 ， 因 为 一 次 最 多 只 有 一 条 记录 有 变 
化 。 


更 新 CrimeListFragment 的 RecyclerView 实 现 逻 辑 ， 只 重 绘 有 过 修改 
的 crime 记 录 。 这 需要 你 更 新 CrimeAdapter， 从 原先 继 

承 RecyclerView.Adapter<CrimeHolder> 改 为 继 

7 androidx.recyclerview.widget.ListAdapter<Crime, 
CrimeHolder>. 


ListAdapter 是 一 个 RecyclerView.Adapter， 它 能 找 出 支 

持 RecyclerView 的 新 旧 数 据 之 间 的 差异 ， 然 后 告诉 它 只 重 绘 有 变化 的 
数据 。 新 旧 数 据 的 比较 在 后 台 线 程 上 完成 ， 所 以 不 会 拖 慢 UI 反 应 。 
ListAdapter 使 用 androidx.recyclerview.widget.DiffUtil 来 诀 
定 哪 一 部 分 的 数据 发 生 了 变化 。 要 完成 本 挑战 ， 你 需要 实现 
DiffUtil.ItemCallback<Crime> 回 调 函 数 。 


另外 ， 你 还 需要 更 新 CrimeListFragment， 提 交 更 新 后 的 crime 列 表 给 


RecyclerView 的 adapter。 你 也 可 以 调 
用 ListAdapter .submitList(MutableList<T>?) 函 数 提 交 一 个 新 列 
表 ， 或 者 配置 LiveData， 观 察 数 据 变化 。 


如 果 需 要 ， 你 还 可 以 查看 androidx.recyclerview.widget.DiffUtil 和 
androidx.recyclerview.widget.ListAdapter 的 API 参 考 页 ， 看 看 该 如 何 使 用 
它 4] o 


第 13 章 对话 框 


对 话 框 既 能 引起 用 户 的 注意 也 可 接收 用 户 的 输入 。 在 提示 重要 信息 或 提 
供用 户 选 项 方面 ， 它 都 非常 有 用 。 本 章 ， 我 们 会 为 CriminalIntent 应 用 添 
加 对 话 框 ， 以 方便 用 户 修改 crime 记 录 日 期 。 用 户 点 击 CrimeFragment 
中 的 日 期 按钮 时 ， 应 用 会 弹出 对 话 框 ， 如 图 13-1 所 示 。 
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图 13-1 可 选择 crime 日 期 的 对 话 框 


图 13-1 中 的 对 话 框 是 DatePickerDialog 类 的 一 个 实 
例 ，DatePickerDialog 是 AlertDialog 的 一 个 子 
类 。DatepPickerDialog 可 以 弹出 一 个 日 期 选择 提示 给 用 户 ， 再 提供 一 


个 监听 器 接口 用 以 获取 用 户 选择 。 如 果 要 创建 更 多 定制 对 话 框 ， 那 么 应 
该 使 用 AlertDialog 类 这 个 最 常用 的 多 用 途 Dialog 子 类 。 


13.1 创建 DialogFragment 


要 使 用 DatePickerDialog， 最 好 是 将 它 封装 

在 DialogFragment (Fragmenti F) 实例 中 。 当 然 ， 不 使 

用 DialogFragment 也 可 显示 DatePickerDialog 视 图 ， 但 不 推荐 这 样 
做 。 使 用 FragmentManager 管 理 DatePickerDialog， 有 更 多 的 定制 选 
项 来 显示 对 话 框 。 


另外 ， 如 果 旋 转 设备 ， 单 独 使 用 的 DatePickerDialog 会 消失 ， 而 封装 
在 fragment 中 的 DatePickerDialog 不 会 有 此 问题 (旋转 后 ， 对 话 框 会 
被 重建 恢复 )。 


就 CriminalIntent 必 用 来 说 ， 我 们 首先 会 创建 名 为 DatePickerFragment 
的 DialogFragment 子 类 。 然 后 ， 在 DatePickerFragment 中 ， 创 建 并 
配置 显示 一 个 DatePickerDialog 实 例 。DatePickerFragment 将 

由 MainActivity 托 管 。 


图 13-2 展 示 了 以 上 各 对 象 间 的 关系 。 


isSolved 


控制 器 
crime 
CrimeDetail ViewModel DatePickerFragment 


DatePickerDialog 


图 13-2 ”由 MainActivity 托 管 的 两 个 fragment 对 象 
要 显示 对 话 框 ， 首 先 应 完成 以 下 任务 : 


e 创建 DatePickerFragment 类 ; 
。 构建 DatePickerFragment; 
e 倍 助 FragmentManager 在 屏幕 上 显示 对 话 框 。 


稍 后 ， 我 们 还 将 在 CrimeFragment 和 DatePickerFragment 之 间 传 递 数 


o 


创建 一 个 名 为 DatePickerFragment 的 新 类 ， 并 设置 
其 DialogFragment 超 类 为 Jetpack 版 的 
androidx.fragment.app.DialogFragment2&. 
DialogFragment 类 包含 如 下 函数 : 


onCreateDialog(savedInstanceState: Bundle?): Dialog 


为 了 在 屏幕 上 显示 DialogFragment， 托 管 activity 的 FragmentManager 
会 调用 它 。 

在 DatePickerFragment. kt 中 ， 添 加 onCreateDialog(Bundle? ) 函 数 的 实 
现代 码 ， 创 建 一 个 带 当前 日 期 的 DatePickerDialog， 如 代码 清单 13-1 
所 示 。 


代码 清单 13-1 创建 DialogFragment (DatePickerFragment.kt) 


class DatePickerFragment : DialogFragment() { 


override fun onCreateDialog(savedInstanceState: Bundle?): Dialog { 
val calendar = Calendar.getInstance() 
val initialYear = calendar. get(Calendar. YEAR) 
val initialMonth = calendar. get(Calendar.MONTH) 
val initialDay = calendar.get(Calendar.DAY OF MONTH) 


return DatePickerDialog( 
requireContext(), 
null, 
initialYear, 
initialMonth, 
initialDay 


DatepickerDialog 构 造 函数 需 要 好 几 个 参数 。 第 一 个 参数 是 用 来 获取 

视图 相关 必需 资源 的 context 对 象 。 第 二 个 参数 是 日 期 监 昕 器 ， 稍 后 会 添 

加 ， 现在 先 传 入 nul1， 最 后 三 个 参数 是 供 日 期 选择 器 初始 化 使 用 的 年 、 

日 初始 值 。 在 知道 某 crime 的 具体 发 生日 期 前 ， 先 初始 化 其 为 当前 
期 。 


w.7\DialogFragment 


和 其 他 fragment 一 样 ，DialogFragment 实 例 也 是 由 托管 activity 的 
FragmentManager 管 理 的 。 


要 将 DialogFragment 添 加 给 FragmentManager 管 理 并 放置 到 屏 
可 调用 fragment 实 例 的 以 下 函数 : 


show(manager: FragmentManager, tag: String) 


show(transaction: FragmentTransaction, tag: String) 


String 参 数 可 唯一 识别 FragmentManager 队 列 中 的 
DialogFragment。 如 果 传 入 FragmentTransaction 参 数 ， 你 自己 负责 


创建 并 提交 事务 ， 如 果 传 入 FragmentManager 参 数 ， 系 统 会 自动 创建 
并 提交 事务 。 


这 里 ， 我 们 选择 传 入 FragmentManager 人 参数 。 
在 CrimeFragment 中 ， 为 DatePickerFragment 添 加 一 个 tag 常 量 。 
然后 ， 在 onCreateView(...) 函 数 中 ， 删 除 禁 用 日 期 按钮 的 代码 。 


为 dateButton 按 钮 添加 OnClickListener 监 听 器 接口 ， 实 现 点 击 日 期 
按钮 展现 DatePickerFragment 界 面 ， 如 代码 清单 13-2 所 示 。 


代码 清单 13-2 ”显示 DialogFragment (CrimeFragment.kt) 


private const val TAG = "CrimeFragment" 
private const val ARG CRIME ID = "crime id" 
private const val DIALOG DATE - "DialogDate" 


class CrimeFragment : Fragment() { 
override fun onCreateView(inflater: LayoutInflater, 
container: ViewGroup?, 


savedInstanceState: Bundle?): View? { 


solvedCheckBox = view.findViewById(R.id.crime solved) as CheckBox 


—3 
return view 
} 
override fun onStart() { 
sol vedchecknex apply { 
; v 
dateButton.setOnClickListener { 


DatePickerFragment().apply { 
show(this@CrimeFragment.requireFragmentManager(), DIALOG D 


我 们 需要 thisQcrimeFragment 来 调用 requireFragmentManager() 。 
注意 ， 这 里 是 从 CrimeFragment 而 不 是 DatePickerFragment 调 

用 requireFragmentManager() 的 。 在 apply 函 数 块 里 ，this 引 用 的 是 
外 部 的 DatePickerFragment， 因 此 ， 这 里 要 加 this 关 键 字 。 


DialogFragment 的 show(FragmentManager，String) 函 数 需要 一 个 
非 空 值 的 fagment 管 理 器 值 参 。Fragment .fragmentManager 属 性 是 可 
空 类 型 值 ， 所 以 ， 这 里 用 的 是 Fragment .requireFragmentManager() 
函数 〈 会 返回 一 个 非 空 值 FragmentManager) 。 在 调 

用 Fragment.requireFragmentManager() 函 数 时 ， 如 果 
Fragment.fragmentManager 属 性 是 空 值 ， 该 函数 会 抛 出 
IllegalStateException 异 常 。 这 表明 ， 目 标 fragment 当 前 没有 关联 的 
fragment 管 理 器 。 


运行 CriminalIntent 心 用 。 点 击 日 期 按钮 弹出 对 话 框 ， 如 图 13-3 所 示 。 
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图 13-3 CAC AY AE 


日 期 选择 对 话 框 看 上 去 不 错 。 下 一 节 ， 我 们 会 配置 它 显 示 crime 日 期 ， 
并 允许 用 户 上 自己 修改 。 


13.2 ”fragment 则 的 数据 传递 


前 面 ， 我 们 实现 了 activity 之 间 〈 使 用 intent 附 加 信息 ) 、fragment 和 
activity 之 间 《〈 使 用 回调 接口 ) 的 数据 传递 。 现 在 需 实 现 同 一 activity 托 管 
的 两 个 fragment (CrimeFragment 和 DatePickerFragment) 之 间 的 数 
据 传递 ， 如 图 13-4 所 示 。 


显示 的 日 期 


DatePickerFragment 


CrimeFragment 


用 户 所 选 日 期 


图 13-4 CrimeFragment 与 DatePickerFragment 间 的 对 话 


要 传递 crime 的 日 期 给 DatePickerFragment， 需 新 建 一 
个 newInstance(Date) 函 数 ， 然 后 将 Date 作 为 argument 附 加 给 
fragment。 


为 返回 新 日 期 给 CrimeFragment， 并 更 新 模型 层 以 及 对 应 视图 ， 你 需要 
在 DatePickerFragment 里 声明 一 个 以 新 日 期 为 参数 的 回调 接口 函数 ， 
如 图 13-5 所 示 。 


CrimeFragment 


1 
crime.getDate() | 
1 


}- —Reminstence(Date) — | DatePickerFragment | DatePickerFragment 


1 
1 
| 
onDateSelected(Date) 


x 


crime.setDate(...) 


1 
| 
1 
1 
1 
1 
1 
1 
l 
1 
1 
1 
i 
1 
Y 


<-- 


图 13-5 ”CrimeFragment 和 DatePickerFragment 间 的 事件 流 


13.2.1 传递 数据 给 DatePickerFragment 


要 传递 crime 日 期 给 DatePickerFragment， 需 将 它 保存 
在 DatePickerFragment 的 argument bundle 中 。 这 
样 ，DatePickerFragment 就 能 直接 获取 它 。 


创建 和 设置 fragment argument 通 常 是 在 newInstance(...) 了 水 数 中 完成 
的 〈 详 见 第 12 章 ) 。 在 DatePickerFragment.kt 中 ， 在 一 个 伴生 对 象 中 添 


加 一 个 newInstance(Date) 函 数 ， 如 代码 清单 13-3 所 示 。 


代码 清单 13-3 ”添加 newInstance(Date) 函 数 
(DatePickerFragment.kt ) 


private const val ARG DATE = "date" 


class DatePickerFragment : DialogFragment() { 


override fun onCreateDialog(savedInstanceState: Bundle?): Dialog { 


} 


companion object { 
fun newInstance(date: Date): DatePickerFragment { 
val args = Bundle().apply { 
putSerializable(ARG DATE, date) 


} 


return DatePickerFragment().apply { 
arguments = args 


然后 ， 在 CrimeFragment 中 ， 
FaDatePickerFragment.newInstance(Date) KH% 
#kDatePickerFragmentiiMJie kay, "fh 4213-4 ATA - 


代码 清单 13-4 添加 对 newInstance(. ..) 的 调用 
( CrimeFragment.kt) 


override fun onStart() { 


dateButton.setOnClickListener { 


— —PatePickerFragment(Q-apply—t 
DatePickerFragment.newInstance(crime.date).apply ( 
show(this@CrimeFragment.requireFragmentManager(), DIALOG DATE) 


} 


DJ SCR 


DatePickerFragment 使 用 Date 中 的 信息 来 初始 化 DatePickerDialog 
对 象 。 然 而 ，DatePickerDialog 对 象 的 初始 化 需 整 数 形式 的 月 、 日 、 
年 。Date 是 时 间 戳 ， 无 法 直接 提供 整数 值 。 


要 达到 目的 ， 必 须 首 先 创 建 一 个 Calendar 对 象 ， 然 后 用 Date 对 象 配置 
它 ， 再 从 Calendar 对 象 中 取 回 所 需 信 息 。 


在 onCreateDialog(Bundle?) 峭 数 中 ， 从 argument 中 获取 Date 对 象 ， 
然后 用 它 和 calendar 对 象 初始 化 DatePickerDialog， 如 代码 清单 13-5 
所 示 。 


代码 清单 13-5 ”获取 Date 对 象 并 初始 
化 DatePickerDialog (DatePickerFragment.kt ) 


class DatePickerFragment : DialogFragment() { 


override fun onCreateDialog(savedInstanceState: Bundle?): Dialog { 
val date = arguments?.getSerializable(ARG_DATE) as Date 
val calendar = Calendar.getInstance() 
calendar.time = date 
val initialYear = calendar.get(Calendar. YEAR) 
val initialMonth = calendar. get(Calendar.MONTH) 
val initialDate = calendar.get(Calendar.DAY OF MONTH) 


return DatePickerDialog( 
requireContext(), 
null, 
initialYear, 
initialMonth, 
initialDate 


现在 ，CrimeFragment 成 功 地 向 DatePickerFragment 传 递 了 日 期 。 运 
行 CriminalIntent 必 用 ， 看 看 效果 如 何 。 


13.2.2 ”返回 数据 给 CrimeFragment 


要 让 CrimeFragment 接 收 DatePickerFragment 返 回 的 日 期 数据 ， 首 先 
需要 搞 清楚 它们 之 间 的 关系 。 


如 果 是 activity 的 数据 回 传 ， 那 么 我 们 调 
FdstartActivityForResult(...)eal, ActivityManager fA vi ERE 
管理 activity 父 子 关 系 。 回 传 数 据 后 ， 子 activity 被 销毁 ， 

但 ActivityManager 知 道 哪个 activity 该 接收 数据 。 


01. 设置 目标 fragment 


类 似 于 activity 间 的 关联 ， 可 将 CrimeFragment 设 置 

成 DatePickerFragment 的 目标 fragment。 这 样 ， 

在 CrimeFragment 和 DatepPickerFragment 被 销毁 并 重建 后 ， 操 作 
系统 会 重新 关联 它们 。 调 用 以 下 Fragment 函 数 可 建立 这 种 关联 : 


setTargetFragment(fragment: Fragment, requestCode: Int) 


该 函数 有 两 个 参数 : 目标 fragment 以 及 类 似 于 传 
入 startActivityForResult(...) 函 数 的 请 求 代码 。 需 要 时 ， 目 
标 fragment 使 用 请 求 代 码 确 认 是 哪个 fragment 在 回 传 数据 。 


目标 fragment 和 请 求 代 码 由 FragmentManager 负 责 跟踪 管理 ， 我 们 
可 访问 fragment (设置 目标 fragment 的 fragment〉 的 
targetFragment 和 targetRequestCode 属 性 获取 它们 。 


在 CrimeFragment.kt 中 ， 创 建 请 求 代码 常量 ， 然 后 
将 CrimeFragment 设 为 DatePickerFragment 实 例 的 目标 
fragment， 如 代码 清单 13-6 所 示 。 


代码 清单 13-6 ”设置 目标 fragment CCrimeFragment.kt) 


private const val DIALOG DATE = "DialogDate" 
private const val REQUEST DATE = 6 


class CrimeFragment : Fragment() ( 
override fun onStart() ( 


dateButton.setOnClickListener { 
DatePickerFragment.newInstance(crime.date).apply { 


setTargetFragment(this@CrimeFragment, REQUEST_DATE) 
show(this@CrimeFragment.requireFragmentManager(), DIAL 


02. 传递 数据 给 目标 fragment 


建立 CrimeFragment 与 DatePickerFragment 之 间 的 联系 后 ， 需 将 
数据 回 传 给 CrimeFragment。 这 需要 在 DatePickerFragment 里 创 
建 一 个 回调 接口 ， 然 后 在 CrimeFragment 中 去 实现 。 


在 DatePickerFragment 类 中 ， 创 建 只 有 一 个 名 
为 onDateSelected() 的 函数 的 回调 接口 ， 如 代码 清单 13-7 所 示 。 


代码 清单 13-7 创建 回调 接口 (DatePickerFragment.kt) 


class DatePickerFragment : DialogFragment() { 


interface Callbacks { 
fun onDateSelected(date: Date) 
j 


override fun onCreateDialog(savedInstanceState: Bundle?): Dialog ( 


bees 


在 CrimeFragment 中 ， 实 现 Callbacks 回 调 接口 。 
fEonDateSelected() KAHE, ix Acrime H HIF EUL MSs 
FEL13-8 FIT AN o 


代码 清单 13-8 ”实现 回调 接口 (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


override fun onStop() { 


} 


override fun onDateSelected(date: Date) { 
crime.date = date 
updateUI() 


既然 CrimeFragment 能 响应 新 日 期 ， 在 用 户 选 了 日 期 

后 ，DatePickerFragment 就 需要 把 日 期 传递 出 去 。 

在 DatePickerFragment 里 ， 给 DatePickerDialog 添 加 一 个 监 折 
器 ， 把 日 期 发 回 给 CrimeFragment， 如 代码 清单 13-9 所 示 。 


代码 清单 13-9 发 回 日 期 (DatePickerFragment.kt ) 


class DatePickerFragment : DialogFragment() { 


override fun onCreateDialog(savedInstanceState: Bundle?): Dialog { 
val dateListener = DatePickerDialog.OnDateSetListener { 
_: DatePicker, year: Int, month: Int, day: Int -> 


val resultDate : Date = GregorianCalendar(year, month, day 


targetFragment?.let { fragment -> 
(fragment as Callbacks) .onDateSelected(resultDate) 
j 


} 


val date = arguments?.getSerializable(ARG_DATE) as Date 


return DatePickerDialog( 
requireContext(), 


— m 
dateListener, 
initialYear, 
initialMonth, 
initialDate 
) 


} 


OnDateSetListener 能 够 获取 到 用 户 选 择 的 新 日 期 。 第 一 个 参数 
是 指 确定 日 期 的 DatePicker。 这 里 不 需要 用 它 ， 所 以 用 了 一 个 _ 做 
名 字 。_ 表示 不 使 用 的 参数 ， 是 一 个 Kotlin 编 码 约定 。 


用 户 选 择 的 日 期 是 年 、 月 、 日 的 形式 ， 而 我 们 需要 一 个 Date 对 象 才 
能 返回 CrimeFragment。 因 此 ， 我 们 把 年 、 月 、 日 数据 传 给 
GregorianCalendar， 再 访问 它 的 time 属 性 得 到 需要 的 Date 对 
象 。 


取 到 想 要 的 日 期 后 ， 束 要 把 它 发 回 给 
CrimeFragment。targetFragment 属 性 保存 的 是 启动 
DatePickerFragment 的 fragment 实 例 。 既 然 目标 fragment 可 能 大 
空 ， 那 么 我 们 把 它 放 在 一 个 结合 了 安全 调用 操作 符 的 let 函 数 里 。 
然后 ， 把 fragment 实 例 类 型 转换 为 Ccallbacks 接 口 ， 调 

用 onDateselected() 函 数 传 入 新 日 期 。 


日 期 数据 的 双 癌 流动 完成 了 。 运 行 CriminalIntent 应 用 ， 确 保 可 以 控 
制 日 期 的 传递 与 显示 。 修 改 某 项 Crime 的 日 期 ， 确 认 
CrimeFragment 视 图 显示 了 新 日 期 。 然 后 返回 crime 列 表 项 界面 ， 
查看 对 应 Crime 的 日 期 ， 并 确认 模型 层 数 据 也 得 到 了 更 新 。 


13.3 ”挑战 练习 : 时 间 选 择 对 话 框 


写 一 个 名 为 TimePickerFragment 的 对 话 框 fragment， 让 用 户 使 用 一 
个 TimePicker 部 件 选择 crime 发 生 的 具体 时 间 。 在 CrimeFragment 界 面 
上 再 添加 一 个 按钮 ， 当 用 户 点 击 时 就 显示 TimePickerFragment 时 间 选 
择 对 话 框 。 


A >r M. 

第 14 半 ”应 用 三 

优秀 的 Android 应 用 部 注重 应 用 栏 设计 。 应 用 栏 可 放置 沫 单 选项 操作 、 
提供 应 用 导航 ， 还 能 帮助 统一 设计 风格 、 塑 造 品 牌 形象 。 


本 章 ， 我 们 将 为 CriminalIntent 应 用 创建 应 用 栏 菜 单 ， 让 用 户 能 够 新 增 
crime 记 录 ， 如 图 14-1 所 示 。 
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应 用 栏 一 一 > Criminallntent 


Stolen scooter ~ 
Mon May 27 11:04:58 EDT 2019 用 于 新 增 criem 
记录 的 菜单 项 


图 14-1 CriminalIntent 的 应 用 栏 


应 用 栏 还 有 其 他 的 不 同 叫 法 ， 比 如 操作 栏 或 工具 栏 。 虽 然 大 家 经 常 交 从 
使 用 这 些 术 语 ， 但 它们 还 是 有 一 些 细微 差异 的 。 详 情 请 参阅 14.4 节 。 


14.1 AppCompat 默 认 应 用 栏 


如 图 14-2 所 示 ，CriminalIntent 应 用 已 经 有 了 一 个 简单 的 应 用 栏 。 
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unprofessional dishes in storage room Qo 
Fri May 10 14:54:30 EDT 2019 


toxic lunch in copy room 
Fri May 10 14:54:39 EDT 2019 


messy sink at reception desk 


Fri May 10 14:54:54 EDT 2019 


unproductive sink in copy room 
Fri May 10 14:54:54 EDT 2019 


dirty sink at reception desk 


Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board at reception Qo 
Fri May 10 14:54:54 EDT 2019 


unproductive shoes in copy room Qo 
Fri May 10 14:54:54 EDT 2019 


unproductive garbage can in storage room Po 
Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board in bathroom 


Fri B 0 14:54:54 EDT 2019 


图 14-2 CriminalImntent 心 用 的 应 用 栏 


这 是 因为 Android Studio 在 创建 新 项 目 时 ， 会 为 所 有 继 
承 AppCompatActivity 的 activity 添 加 一 个 默认 应 用 栏 。 有 具 体 做 法 如 
F: 


。 添加 Jetpack AppCompat 基 础 依赖 项 ; 
e. 采用 目 带 应 用 栏 的 一 种 AppCompat 主 题 。 


打开 app/build.gradle 文 件 ， 可 以 看 到 Android Studio 添 加 的 AppCompat 依 
赖 项 : 


dependencies { 


implementation 'androidx.appcompat:appcompat:1.0.0-beta01' 


*AppCompat"7é “application compatibility”( 应 用 兼容 性 ) 的 缩写 。 
Jetpack 版 AppCompat 基 础 库 里 有 很 多 核心 类 和 资源 ， 可 以 让 各 个 
Android 系 统 版 本 的 应 用 UI 保持 风格 统一 。AppCompat 子 包 里 到 底 有 哪 
些 API， 可 详 见 Google 官 方 API 清 单 。 


在 创建 新 项 目 时 ，Android Studio 会 自动 设置 新 应 用 的 主题 为 
Theme.AppCompat.Light.DarkActionBar。 在 res/values/styles.xml 文 件 中 ， 
该 主题 为 整个 应 用 指定 默认 样式 : 


<resources> 


<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


</resources> 


fEAndroidManifest.xml XF F, EA DARE HI ZO EL. thay VAR 
activity E. 1TJFmanifests/AndroidManifest.xml X fF, Æ 

看 <application> 标 签 的 android:theme 属 性 ， 应 该 可 以 看 到 如 下 主 
题 设置 : 


<manifest ... > 
<application 


android: theme="@style/AppTheme" > 


</application> 
</manifest> 


在 第 21 章 中 ， 我 们 还 会 进一步 学 习 样式 和 主题 相关 的 知识 。 现 在 ， 可 以 
HS FI ESSERE. 


14.2 MHF KE 


应 用 栏 菜单 由 菜单 项 〈 又 称 操 作 项 ) 组 成 ， 它 占据 着 应 用 栏 的 右上 方 区 
域 。 沈 单项 的 操作 应 用 于 当前 屏幕 ， 甚 至 整个 应 用 。 现 在 ， 我 们 来 添加 
允许 用 户 新 增 crime 记 录 的 菜单 项 。 


沫 单 及 荣 单 项 需 用 到 一 些 字 符 串 资源 。 参 照 代 码 清单 14-1， 将 它们 添加 
到 res/values/strings.xml 文 件 中 。 


代码 清单 14-1 添加 字符 串 资 源 (res/values/strings.xml ) 


<resources> 


<string name="crime_solved_label">Solved</string> 


<string name="new_crime">New Crime</string> 


</resources> 


14.2.1 在 XML 文件 中 定义 菜单 


某 单 是 一 种 类 似 于 布局 的 资源 。 创 建 菜 单 定 义 文件 并 将 其 放置 在 
res/menu 目录 后 ，Android 会 自动 生成 相应 的 资源 ID。 随 后 ， 在 代码 中 实 
例 化 菜单 时 ， 束 可 以 直接 使 用 。 


在 项 目 工 具 窗 口中 ， 右 键 单 击 res 目 录 ， 选 择 New > Android resource file 
菜单 项 。 在 弹出 的 窗口 界面 ， 选 择 Menu 资 源 类 型 ， 并 命名 资源 文件 为 
fragment_crime_list， 点 击 OK 按 钮 确认 ， 如 图 14-3 所 示 。 


eo ® New Resource File 


File name: fragment_crime_list 11 
Resource type: Menu v 

Root element: menu 

Source set: main v 


Directory name: | menu 


Available qualifiers: Chosen qualifiers: 


$3 Country Code = 


@: Network Code 
@ Locale 


? Cancel NONI 
图 14-3 ”创建 菜单 定义 文件 


这 里 ， 这 单 定 义 文 件 遵 循 了 与 布局 文件 一 样 的 命名 原则 。Android Studio 
会 创建 res/menu/fragment_crime_list.xml 文 件 。 这 个 文件 和 
CrimeListFragment 的 布局 文件 同名 ， 但 分 别 位 于 不 同 的 目录 中 。 打 
FAE fragment. crime list.xmlc fF. ARAR 14-2, WMA 
item 元 素 。 


代码 清单 14-2 创建 菜单 资源 Cres/menu/fragment crime list.xml) 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 
android: id="@+id/new_crime" 


android: icon="@android:drawable/ic_menu_add" 
android: title="@string/new_crime" 
app: showAsAction="ifRoom|withText"/> 

«/menu» 


showAsAction/&TEH] T TE GE GE IPIE TEM AEE, ee eT wu 
H Coverflow menu) 中 。 该 属性 当前 设置 为 ifRoom 和 withText 的 
组 合 值 。 因 此 ， 只 要 空间 足够 ， 沫 单项 图 标 及 其 文字 描述 都 会 显示 在 应 
用 栏 上 。 如 果 空 间 仅 够 显示 沫 单项 图 标 ， 文 字 描述 就 不 会 显示 ;， 如 采 空 
间 大 小 不 够 显示 任何 项 ， 沫 单项 就 会 隐藏 到 溢出 染 单 中 。 


如 有 果 洲 出 有 日 包含 其 他 项 ， 它 们 束 会 以 三 个 点 表示 “位 于 应 用 栏 最 石 
W) ， 如 图 14-4 所 示 。 稍 后 ， 我 们 会 更 新 代码 添加 这 样 的 末 蛙 项 。 


9:00 US d 


Criminallntent 


图 14-4 应 用 栏 中 的 溢出 菜单 


属性 showAsAction 还 有 另外 两 个 可 选 值 : always 和 never。 不 推荐 使 
用 always， 应 尽量 使 用 ifRoom 属 性 值 ， 让 操作 系统 决定 如 何 显示 菜单 
项 。 对 于 那些 很 少 用 到 的 菜单 项 ，never 属 性 值 是 个 不 错 的 选择 。 总 
之 ， 为 了 避免 用 户 界 面 混乱 ， 应 用 栏 上 只 应 放置 党 用 菜单 项 。 


app 命 名 空间 


注意 ， 不 同 于 常见 的 android 命 名 空间 声明 ，fragment_crime _list.xml 文 
件 使 用 xmlns 标 签 定义 了 全 新 的 app 命 名 空间 。 指 定 showAsAction 属 性 
时 ， 融 用 了 这 个 新 定义 的 命名 空间 。 


出 于 兼容 性 考虑 ，AppCompat 库 需要 使 用 app 命 名 空间 。 应 用 栏 API〈 有 
时 又 叫 “ 操 作 栏 >) 随 Android 3.0 引 入 。 为 了 支持 各 种 旧 系 统 版 本 设备 ， 
早期 创建 的 AppCompat 库 捆绑 了 兼容 版 操作 栏 。 这 样 一 来 ， 不 管 新 旧 ， 
所 有 设备 都 能 用 上 操作 栏 。 在 运行 Android 2.3 或 更 早 版 本 系统 的 设备 
上 ， 菜 单 及 其 相应 的 XML 文 件 确实 是 存在 的 ， 

但 android:showAsAction 属 性 是 随 着 操作 栏 的 发 布 才 添加 的 。 


AppCompat 库 不 希望 使 用 原生 showAsAction 属 性 ， 因 此 ， 它 提供 了 定 
制版 showAsAction 属 性 Capp:showAsAction) . 


14.2.2 ”创建 菜单 


在 代码 中 ，Activity 类 提供 了 管理 表单 的 回调 冰 数 。 需 要 选项 菜 单 
时 ，Android 会 调用 Activity 的 onCreateOptionsMenu(Menu) 函数 。 


然而 ， 按 照 CriminalIntent 应 用 的 设计 ， 与 选项 染 单 相关 的 回调 函数 需 在 
fragment 而 非 activity 里 实现 。 不 用 担心 ，Fragment 有 一 套 自 己 的 选项 滋 
单 回调 函数 。 稍 后 ， 我 们 会 在 CrimeListFragment 中 实现 这 些 函 数 。 
以 下 为 创建 菜单 和 啊 应 沫 单项 选择 事件 的 两 个 回调 函数 : 


onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) 


onOptionsItemSelected(item: MenuItem): Boolean 


ftCrimeListFragment.ktH, 7% tonCreateOptionsMenu(Menu, 
MenuInflater) 函 数 ， 实 例 化 fragment_crime_list.xml 中 定义 的 菜单 ， 如 
代码 清单 14-3 所 示 。 


代码 清单 14-3 ”实例 化 选项 来 单 〈CrimeListFragment.kt ) 


class CrimeListFragment : Fragment() { 


override fun onDetach() { 
super .onDetach() 
callbacks = null 

} 


override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
super.onCreateOptionsMenu(menu, inflater) 
inflater.inflate(R.menu.fragment_crime_list, menu) 


ELL Eee, FAT MenuInflater.inflate(Int, Menu) A žit 
ee Hiti Jeg SCE AE CI] SEL H XR S SlIMenu SE 
列 中 。 


注意 ， 我 们 也 调用 了 超 类 的 onCreate0ptionsMenu(...) 函 数 。 当 然 ， 
也 可 以 不 调用 ， 但 作为 一 项 开发 约定 ， 有 理由 推荐 这 么 做 。 调 用 该 超 类 
函数 ， 任 何 超 类 定义 的 选项 染 单 功 能 在 子 类 函数 中 都 能 获得 应 用 。 不 
过 ，onCreate0ptionsMenu(...) 的 基 类 实现 什么 也 没 做 ， 仅 仅 是 遵循 
约定 而 已 。 


Fragment.onCreate0ptionsMenu(Menu，MenuInflater) 函 数 是 
由 FragmentManager 负 责 调用 的 。 因 此 ， 当 activity 接 收 到 操作 系统 的 
onCreate0ptionsMenu(...) 函 数 回 调 请 求 时 ， 我 们 必须 明确 告诉 
FragmentManager， 其 管理 的 fragment 应 接 

收 onCreateOptionsMenu(...) 函 数 的 调用 指令 。 要 通知 
FragmentManager， 需 调用 以 下 函数 : 


setHasOptionsMenu(hasMenu: Boolean) 


4E LCrimeListFragment.onCreate(Bundle?) mA, ik 
FragmentManager 知 道 CrimeListFragment 需 接收 选项 菜单 函数 回 
调 ， 如 代码 清单 14-4 所 示 。 


代码 清单 14-4 ”接收 选项 羔 单 函数 回调 (CrimeListFragment.kt) 


class CrimeListFragment : Fragment() { 


override fun onAttach(context: Context) { 


} 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setHasOptionsMenu(true) 


运行 CriminalIntent 详 用 ， 查 看 新 创建 的 菜单 项 ， 如 图 14-5 所 示 。 
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unprofessional dishes in storage room 9o 
Fri May 10 14:54:30 EDT 2019 


toxic lunch in copy room 
Fri May 10 14:54:39 EDT 2019 


messy sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


unproductive sink in copy room 
Fri May 10 14:54:54 EDT 2019 


dirty sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board at reception 


desk Qo 


Fri May 10 14:54:54 EDT 2019 


unproductive shoes in copy room 9o 
Fri May 10 14:54:54 EDT 2019 


unproductive garbage can in storage room 
Fri May 10 14:54:54 EDT 2019 


g j erase board in bathroom 


图 14-5 ”显示 在 应 用 栏 上 的 菜单 项 图 标 


表单 项 标题 怎么 没有 显示 ?大 多 数 手机 在 竖 屏 模式 下 屏幕 空间 有 限 。 因 
此 ， 应 用 的 应 用 栏 只 够 显示 沫 单项 图 标 。 长 按 应 用 栏 上 的 染 单 项 图 标 ， 
可 弹出 标题 ， 如 图 14-6 所 示 。 
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unprofessional dishes in storage "S 
Fri May 10 14:54:30 EDT 2019 
toxic lunch in copy room 


Fri May 10 14:54:39 EDT 2019 


messy sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


unproductive sink in copy room 
Fri May 10 14:54:54 EDT 2019 


dirty sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


overflowing dry erase board at reception 


desk Qo 


Fri May 10 14:54:54 EDT 2019 


unproductive shoes in copy room 9o 
Fri May 10 14:54:54 EDT 2019 


unproductive garbage can in storage room 
Fri May 10 14:54:54 EDT 2019 


«4 j erase board in bathroom 


图 14-6 长 按 应 用 栏 上 的 图 标 ， 显 示 沫 单项 标题 


横 屏 模式 下 ， 应 用 栏 会 有 足够 的 空间 同时 显示 沫 单项 图 标 和 标题 ， 如 图 
14-7 所 示 。 
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unprofessional dishes in storage room Q 
Fri May 10 14:54:30 EDT 2019 O 


toxic lunch in copy room 
Fri May 10 14:54:39 EDT 2019 


messy sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


unproductive sink in copy room 
Fri May 10 14:54:54 EDT 2019 


dirty sink at reception desk 
Fri May 10 14:54:54 EDT 2019 


图 14-7 EE hz KIE Ep UU ek 

14.2.3 ”响应 菜单 项 选择 

为 了 响应 用 户 点 击 New Crime 菜 单项 ， 需 实现 新 方法 向 数据 库 中 添加 新 
的 Crime。 在 CrimeListViewModel.kt 中 ， 新 增 一 个 addCrime(Crime) 函 
数 ， 如 代码 清单 14-5 所 示 。 


代码 清单 14-5 ”添加 新 的 crime (CrimeListViewModel.kt) 


class CrimeListViewModel : ViewModel() { 


private val crimeRepository = CrimeRepository.get() 
val crimeListLiveData = crimeRepository.getCrimes() 


fun addCrime(crime: Crime) { 
crimeRepository.addCrime(crime) 


) 


“OA Se FASE ALIA, fragment 
到 on0ptionsItemselected(MenuItem) 函 数 的 回调 请 求 。 传 入 该 函数 
的 参数 是 一 个 描述 用 户 选 择 的 MenuItem 实 例 。 


SRA TTL, {ACAI Le PRI EI i Be AL 
TID, FY WATE BAIN ESSE, PA aC A DM AID 


际 束 是 在 亲 单 定义 文件 中 赋予 菜单 项 的 资源 ID。 
在 CrimeListFragment.kt 中 ， 实 现 on0ptionsItemSelected(MenuItem) 
函数 ， 以 啊 应 染 单 项 的 选择 事件 。 在 该 函数 中 ， 创 建新 的 Crime 实 例 ， 
将 其 保存 到 数据 库 中 ， 然 后 通知 父 activity 实 例 ， 新 Crime 记 录 忆 被 选 
中 ， 如 代码 清单 14-6 所 示 。 

代码 清单 14-6” 啊 应 染 单 项 选择 事件 〈CrimeListFragment.kt ) 


class CrimeListFragment : Fragment() { 


override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
super.onCreateOptionsMenu(menu, inflater) 
inflater.inflate(R.menu.fragment_crime_list, menu) 


} 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
return when (item.itemId) { 
R.id.new crime -> { 
val crime - Crime() 
crimeListViewModel.addCrime(crime) 
callbacks?.onCrimeSelected(crime.id) 
true 


} 


else -> return super.onOptionsItemSelected(item) 


注意 ，onOptionsItemSelected(MenuItem) 函 数 返回 的 是 布尔 值 。 一 
旦 完成 菜单 项 事件 处 理 ， 该 函数 应 该 返回 true 值 以 表明 任务 已 完成 。 如 
果 返 回 false 值 ， 就 调用 托管 activity 的 
onOptionsItemSelected(Menultem) 函数 继续 。【〈 如 果 托 管 activity 托 
管 了 其 他 fragment， 那 么 它们 也 会 调用 onoptionsItemselected 函 

a ) 另外 ， 默 认 情 况 下 ， 如 果菜 单项 ID 不 存在 ， 超 类 版 本 函数 会 被 调 


现在 ， 既 然 你 能 自己 添加 新 crime 记 录 ， 那 么 之 前 准备 的 种 子 数据 库 数 
据 就 可 以 删除 了 。 打 开 Device File Explorer 工 具 窗口 ， 展 开 data/data 文 件 
来， 找到 并 展开 以 你 的 应 用 包 名 命名 的 文件 夹 ， 石 键 单 击 databases 文 件 
夹 并 删除 ， 如 图 14-8 所 示 。 


Device File Explorer je] c 
mE Emulator Pixel 2. API 28 Android 9, API 28 v 


Name Date Size 
com.anaroia.walpaperoackup ZUT9-U3-1U; 4 KB 
com.bignerdranch.android.be. 2019-03-10 ; 4 KB 
com.bignerdranch.android.blc 2019-03-10 : 4 KB 
com.bignerdranch.android.cri 2019-03-10 : 4 KB 

cache 2019-05-27 ' 4 KB 
code_cache 2019-05-27’ A KB 
com.bignerdranch.android.ge 2019-03-10 | 4 KB 
com.bignerdranch.android.ph 2019-03-10 : 4 KB 


图 14-8 ”删除 数据 库 文件 


注意 ， 你 的 data/data/your.package.name 文 件 夹 里 的 文件 可 能 和 图 14-8 所 
示 的 不 太一 样 ， 这 没关系 ， 只 要 数据 库 文 件 删 挥 了 束 可 以 。 


运行 CriminalIntent 应 用 ， 你 会 看 到 一 个 空 列表 。 尝 试 使 用 菜单 ， 添 加 一 
条 crime 记 录 ， 如 图 14-9 所 示 。 


Criminallntent M o New Crime 


New Crime Stolen scooter 


Mon May 27 11:04:58 EDT 2019 


Stolen scooter 


DETAILS 
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图 14-9 创建 新 crime 记 录 


新 增 crime 记 录 前 ， 空 空 如 也 的 列表 看 上 去 不 够 专业 。 不 过 ， 不 用 担 
心 ， 完 成 14.6 节 的 “挑战 练习 ”后 ， 你 就 知道 该 怎么 做 了 。 


14.3 ”使 用 Android Asset Studio 
应 用 使 用 的 图 标 有 两 种 : 系统 图 标 和 项 目 资 源 图 标 。 系 统 图 标 Csystem 


icon) 是 Android 操 作 系 统 内 置 的 图 标 。android:icon 属 性 
值 @android:drawable/ic_menu_add 就 引用 了 系统 图 标 。 


在 应 用 原型 设计 阶段 ， 使 用 系统 图 标 不 会 有 什么 问题 ， 而 在 应 用 发 布 
时 ， 无 论 用 户 运 行 什么 设备 ， 最 好 能 统一 应 用 的 界面 风格 。 要 知道 ， 不 
同 设 备 或 操作 系统 版 本 间 ， 系 统 图 标的 显示 风格 差异 很 大 。 有 些 设备 的 
系统 图 标 甚 至 与 应 用 的 整体 风格 完全 不 匹配 。 


一 种 解决 方案 是 创建 定制 图 标 。 这 需要 针对 不 同 屏 幕 显 示 密 度 或 各 种 可 
能 的 设备 配置 ， 准 备 不 同 版 本 的 图 标 。 可 查看 Android 的 图 标 设计 指 
南 ， 了 解 更 多 相关 信息 。 


另 一 种 解决 方案 是 找到 适合 应 用 的 系统 图 标 ， 将 它们 直接 复制 到 项 目的 
drawable 资 源 目 录 中 。 


系统 图 标 可 在 Android SDK 的 安装 目录 下 找到 。 如 果 是 Mac 计 算 机 ， 路 
径 通 常 为 /Users/user/Library/Android/sdk; 如 果 是 windows 计 算 机 ， 默 认 
的 路 径 是 \Users\usemsdk。 上 此外， 还 可 以 打开 项 目 结构 窗口 (File > 
Project Structure) ， 选 择 Android SDK location 来 确认 SDK 的 具体 存放 路 


Z 
径 。 


打开 SDK 目 录 ， 可 找到 包括 ic_menu_add 在 内 的 Android 系 统 资源 。 资 源 
的 具体 目录 是 /platforms/android-XX/data/res， 路 径 中 的 数字 XX 代 表 
Android 的 API 级 别 。 例 如 ， 对 于 API 28 级 ，Android 资 源 路 径 是 
platforms/android-28/data/res 。 


还 有 第 三 个 、 也 是 最 容易 的 解决 方案 : 使 用 Android Studio 内 置 的 
Android Asset Studio 工 具 。 你 可 以 用 它 为 应 用 栏 创建 或 定制 图 片 。 


在 项 目 工 具 窗 口中 ， 右 键 单 击 drawable 目 录 ， 选 择 New — Image Asset 菜 
单项 ， 弹 出 如 图 14-10 所 示 的 Asset Studio 窗 口 。 


000 Asset Studio 


Configure Image Asset 


Android Studio 


Icon Type: ‘Acton Bar and Tab cons v Preview 


Name: ic menu add 
Asset Type: © image © Clip Art Ô Text 


Clip Art; [ + | 


Trim: — OYe Q No anydol  — xxhdpi  xhdpi hdpi mdpi 


Padding: Aaa a 0% 


| 
| 
| 


Te MUDK Y 


0 | Cancel | Previous Finish 
14-10 Android Asset Studio 
这 里 ， 你 可 以 生成 各 种 图 标 。 作 为 测试 ， 我 们 来 给 新 建 crime 操 作 项 制 


作 一 个 新 图 标 。 在 Icon Type 一 栏 选 择 Action Bar and Tab Icons， 在 Name 
一 栏 输 入 ic_menu_add， 在 Asset Type 处 选择 Clip Art. 


更 新 Theme 为 HOLO_DARK。 由 于 应 用 栏 使 用 了 深 色 系 主题 ， 因 此 图 标 
应 选 浅 色 。 


现在 ， 点 击 Clip Art 按 钮 挑选 前 贴画 图片 。 在 弹出 的 剪贴 画 窗 口 ， 选 择 
看 上 去 像 + 号 的 图 片 ， 如 图 14-11 所 示 。 《你 也 可 以 在 左上 搜索 框 里 输 
入 “add” 节 约 查找 时 间 。 ) 


e e Select Icon 
Q N I~ — ° 
» X © Oo Tt 
Action 3d rotation m access alarms access time a y 
Alert e E G 2 
Audio/Video & ral a mR Ww 
H t == 
Communication accessible account balance account balance v a OX account circle adb 
Content 
tA 
x n o apoo 
Editor "€ 
File add a photo larm add alert add add box dd 
Hardware 中 
Image © Q Y (ES 
ee 
Maps e j t jd add shopping cari add to photos add 
Navigation 


These icons are available under the Apache License Version 2.0 


Cancel EG 


图 14-11 可 选 的 剪贴 画 + 号 在 哪里 


点 击 OK 按 钮 确认 ， 然 后 点 击 Next 按 钮 进入 如 图 14-12 所 示 的 预览 画面 。 
这 个 预览 画面 告诉 我 们 ，Asset Studio 会 产生 hdpi、mdpi、xhdpi 和 xxhdpi 
类 型 的 图 标 。 真 是 太 方便 了 ! 


009 Asset Studio 


Confirm Icon Path 


Android Studio 


Output Directories vim O vector xalns:androdds"http://schenas, android, con/aph/res/android’ | 
| androidiwidthe"24dp" 
7 Ses (o aniroiditegite d" 
* H drawable-anydpi | ip 
P5 (0 android:vievportieight" H" 
Draiman anda tints FFP 
* P draweble-xxhdpi | qti 
£c action name png | android: fil\Color="#FFQ00000" 
v P crawableexhdp! | L a DOO [> 
© ic action name png | 
Y D drawable-hdpi 
2 ic action name png 
Y D drawable-mdpi | 
Í ic action name png | 
0 | Cancel | | Previous | Net — BEI 


[414-12 Asset Studio 的 生成 文件 


扩 击 Finish 按 钮 生成 图 像 。 然 后 ， 修 改 布局 文件 中 的 android:icon 属 
性 ， 在 项 目 中 使 用 新 图 像 ， 如 代码 清早 14-7 所 示 。 


代码 清单 14-7 引用 本 地 资源 Cres/menu/fragment crime list.xml) 


<item 
android: id="@+id/new_crime" 


android: icon="@drawable/ic_menu_add" 
android: title="@string/new_crime" 
app: showAsAction="ifRoom|withText"/> 


运行 应 用 ， 欣 赏 一 下 新 图 标 。 如 图 14-13 所 示 ， 现 在 ， 应 用 无 论 安装 在 
哪个 Android 系 统 版 本 上 ， 新 图 标 看 上 去 都 一 样 了。 
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Stolen scooter 
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图 14-13 ”更 新 后 的 新 图 标 


144 深入 学 习 : 应 用 栏 、 操 作 栏 与 工具 栏 


经 第 听 到 人 们 把 应 用 栏 称 作 “ 工 具 栏 ”或 “操作 栏 >?。Android 官 方 文档 也 和 营 
常 交 伏 使 用 这 些 术 语 。 那 么 ， 应 用 栏 、 工 具 栏 和 操作 栏 究竟 有 没有 区 别 
We? 有 。 这 些 术语 有 关联 ， 但 事实 上 ， 它 们 并 不 完全 一 样 。 


应 用 栏 、 工 具 栏 和 操作 栏 的 UI 设计 元 素 本 身 就 叫 应 用 栏 。Android 

5.0 (Lollipop，API21 级 ) 之 前 ， 应 用 栏 都 是 使 用 ActionBar 类 来 实现 
的 。 屠 时， 术语 “操作 栏 " 和 “应 用 栏 * 就 是 完全 一 样 的 概念 。 自 Android 
5.0 开 始 ， 应 用 栏 都 是 优先 使 用 新 引入 的 Toolbar 类 来 实现 的 。 


本 书 撰写 时 ，AppCompat 使 用 Jetpack 版 Toolbar 部 件 来 实现 应 用 栏 ， 如 


图 14-14 所 示 。 


View Tree Q $ - Loa Overlay gw 
Y C DecorView 
Y [T UnearLayout 
Y [E] FrameLayout 
Y Clid/decor content parent (ActionBarOverlayLayout) 
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图 14-14 ”应 用 栏 视 图 布局 检查 器 


ActionBar 和 Toolbar 是 两 个 非常 相似 的 组 件 。 工 具 栏 建立 在 操作 栏 基 
础 之 上 。 除 了 UI 视觉 上 调整 ， 在 使 用 上 ， 工 具 栏 比 操作 栏 更 灵活 。 


操作 栏 的 使 用 限制 很 多 ， 比 如 ， 整 个 应 用 只 能 配置 一 个 操作 栏 且 位 置 及 
尺寸 必须 固定 在 屏幕 项 部 ) 。 工 具 栏 就 没有 这 些 限制 。 


本 章 使 用 的 工具 栏 应 用 了 AppCompat 主 题 。 如 果 有 需要 ， 也 可 以 通过 
activity 和 fragment 布 局 定制 标准 视图 的 工具 栏 。 可 以 在 屏幕 的 任何 位 置 
摆 放 工具 栏 ， 甚 至 可 以 在 同一 屏幕 配置 多 个 工具 栏 。 应 用 设计 的 自由 度 
由 此 大 大 提高 了 ， 例 如 ， 可 以 为 每 个 fragment 定 制 专用 工具 栏 。 可 以 想 
象 ， 在 同一 个 用 户 界 面 托管 多 个 fragment 时 ， 每 个 fragment 都 由 自己 的 
工具 栏 控制 ， 这 比 所 有 fragment 共 享 一 个 位 于 屏幕 项 部 的 工具 栏 方便 多 
is 
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了 解 了 应 用 栏 相关 API 的 历史 演变 ， 碍 阅 应 用 栏 相关 官方 开发 者 文档 就 
更 加 有 的 放 天 了 。 如 果 不 了 解 ， 则 应 用 栏 相关 术语 概念 很 容易 迷惑 人 。 
学 完 本 节 ， 在 增加 知识 的 同时 ， 和 希望 你 乐于 分 享 ， 也 能 帮助 未 来 的 开发 
者 搞 清 它们 的 异同 。 


14.5 深入 学 习 : AppCompat 版 应 用 栏 


我 们 已 经 知道 ， 给 应 用 栏 添加 沫 单项 就 可 以 改变 它 的 内 容 。 除 了 这 些 ， 
你 还 可 以 在 应 用 运行 时 ， 修 改 应 用 栏 的 一 些 其 他 属性 ， 比 如 修改 应 用 栏 
上 显示 的 标题 。 


要 使 用 AppCompat 厂 应 用 栏 ， 你 可 以 引用 AppCompatActivity 的 
supportFragmentManager 属 性 : 


val appCompatActivity = activity as AppCompatActivity 


val appBar = appCompatActivity.supportActionBar as Toolbar 


托管 fagment 的 activity 被 类 型 转换 为 AppCompatActivity。 
CriminalIntent 应 用 用 了 AppCompat 库 ， 它 的 MainActivity 就 
是 AppCompatActivity 子 类 ， 因 此 你 能 用 上 AppCompat 版 应 用 栏 。 


把 supportActionBar 类 型 转换 为 Toolbar 类 型 的 目的 是 能 

上 Toolbar 的 函数 。 (注意 ，AppCompat 使 用 Toolbar 来 实现 其 应 用 
兰 ， 但 它 过 去 一 直 用 的 是 ActionBar。 所 以 ， 代 码 里 使 

用 supportActionBar 属 性 就 没 那么 奇怪 了 。) 


引用 到 AppCompat 版 应 用 栏 之 后 ， 可 以 做 一 些 应 用 栏 设 置 ， 比 如 设置 标 


jel: 


appBar.setTitle(R.string.some_cool title) 


如 果 想 知道 Toolbar〔 假 设 你 的 应 用 栏 是 个 Toolbar) 还 有 哪些 设置 应 
用 栏 内 容 的 函数 可 用 ， 可 以 查阅 Toolbar API 参 考 页 。 


注意 ， 如 果 需 要 修改 当前 activity 用 户 界 面 上 的 应 用 栏 菜单 内 容 ， 可 以 调 
用 invalidateOptionsMenu() 函 数 ， 让 它 触发 
onCreateOptionsMenu(Menu，MenuInflater) 回 调 函 数 来 达到 目 
的 。 在 onCreateOptionsMenu 回 调 函 数 里 ， 编 码 修改 表单 内 容 后 ， 回 
调 一 结束 ， 所 有 修改 立即 生效 。 


14.6 ”挑战 练习 : RecyclerView 空 视图 


当前 ，CriminalIntent 应 用 局 动 后 ， 你 会 看 到 一 个 空空 如 也 的 
RecyclerView。 从 用 户 体 验 上 来 讲 ， 即 使 crime 列 表 是 空 的 ， 也 应 给 个 
提示 或 做 出 解释 。 


请 配置 空 RecyclerView 显 示 类 似 “There are no crime” 的 信息 。 再 添加 一 
个 按钮 ， 方 便 用 户 直 接 创 建新 的 crime 记 录 。 


判断 crime 列 表 是 否 包 含 数 据 ， 然 后 使 用 所 有 视图 类 都 有 的 visibility 
属性 动态 控制 占 位 视图 的 显示 。 


215 隐 式 intent 


在 Android 系 统 中 ， 可 利用 隐 式 intent 启 动 其 他 应 用 的 activity。 在 显 式 
intent 中 ， 指 定 要 局 动 的 activity 类 ， 操 作 系 统 会 负 贡 局 动 它 。 在 隐 陈 
intent 中 ， 只 要 摘 述 要 完成 的 任务 ， 操 作 系 统 就 会 找到 合适 的 应 用 ， 并 
在 其 中 启动 相应 的 activity。 


本 章 ， 我 们 将 使 用 隐 式 intent 发 送 短 消息 给 Crime 嫌 疑 人 。 用 户 首先 从 某 
个 联系 人 应 用 中 选取 联系 人 ， 然 后 从 短 消 息 应 用 列表 中 选取 目标 应 用 发 
送 消 息 ， 如 图 15-1 所 示 。 
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SAT MAR 09 14:37:05 EST 2019 


C] Solved 
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SEND CRIME REPORT 


打开 联系 人 应 用 


打开 消息 发 送 应 用 


图 15-1 打开 联系 人 应 用 和 消息 发 送 应 用 


对 于 开发 者 来 说 ， 使 用 隐 式 intent 利 用 其 他 应 用 完成 常见 任务 ， 远 比 目 
己 编写 代码 从 头 实现 要 容易 得 多 。 对 于 用 户 来 说 ， 他 们 也 乐意 在 应 用 中 


调用 上 自己 熟悉 或 喜爱 的 应 用 。 
创建 隐 式 intent 之 前 ， 需 完成 以 下 准备 工作 : 


。 在 CrimeFragment 的 布局 上 添加 CHOOSE SUSPECT 按 钮 和 SEND 
CRIME REPORT 按 钮 ; 

。 在 Crime 类 中 添加 保存 嫌疑 人 名 字 的 suspect 属 性 ; 

e 使 用 格式 化 的 字符 串 资 源 创建 消息 模板 。 


15.1 添加 按钮 部 件 

首先 ， 在 CrimeFragment 布 局 中 添加 两 个 投诉 用 按钮 : 一 个 嫌疑 人 选取 
按钮 (CHOOSE SUSPECT 按 钮 ) 和 一 个 消息 发 送 按钮 (SEND CRIME 
REPORT 按 钮 ) 。 添 加 按钮 前 ， 先 来 添加 显示 在 按钮 上 的 字符 串 资 源 ， 
如 代码 清单 15-1 所 示 。 


代码 清单 15-1 添加 按钮 字符 串 〈res/values/strings.xml) 


<resources> 


<string name="new_crime">New Crime</string> 


<string name="crime_suspect_text">Choose Suspect</string> 
<string name="crime_report_text">Send Crime Report</string> 
</resources> 


然后 ， 在 res/layout/fragment_crime.xml 布 局 文件 中 ， 添 加 两 个 按钮 部 
件 ， 如 代码 清单 15-2 所 示 。 


代码 清单 15-2 ”添加 按钮 定义 Cres/layout/fragment crime.xml) 


«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
i> 


<CheckBox 
android: id="@+id/crime_solved" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: text="@string/crime_solved_label"/> 


<Button 


android:id="@+id/crime_suspect" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="@string/crime_suspect_text"/> 


<Button 
android:id="@+id/crime_report" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:text="@string/crime_report_text"/> 
</LinearLayout> 


MÆ, UMa I. AEN, tony UA 1T CriminalIntent Hj, 
确认 看 到 了 新 增 按钮 。 


15.2 添加 嫌疑 人 信息 至 模型 层 


接 下 来 ， 返 回 到 Crime.kt 中 ， 新 增 存 储 嫌 疑 人 名 字 的 suspect 成 员 变 
量 ， 如 代码 清单 15-3 所 示 。 


代码 清单 15-3 ”添加 suspect 成 员 变 量 (Crime.kt) 


@Entity 
data class Crime(@PrimaryKey val id: UUID = UUID.randomUUID(), 
var title: String = "", 


var date: Date = Date(), 
var isSolved: Boolean = false, 
var suspect: String = "") 


现在 ， 需 要 新 增 crime 数 据 库 字段 。 这 需要 增加 CrimeDatabase 类 的 版 
本 写 ， 以 及 告诉 Room 如 何在 不 同 版 本 间 迁 移 数 据 库 。 


为 告诉 Room 数据 库 版 本 有 变化 ， 你 需要 添加 一 个 Migration。 打 开 
CrimeDatabase.kt， 修 改 数据 库 版 本 ， 再 添加 一 个 Migration， 如 代码 清 
单 15-4 所 示 。 


代码 清单 15-4 添加 数据 库 迁 移 类 (database/CrimeDatabase.kt ) 


@Database(entities = [ Crime::class ], 


— —versien-i 


— version=2) 
@TypeConverters(CrimeTypeConverters: :class) 
abstract class CrimeDatabase : RoomDatabase() { 


abstract fun crimeDao(): CrimeDao 


} 


val migration 1 2 = object : Migration(1, 2) ( 
override fun migrate(database: SupportSQLiteDatabase) { 
database.execSQL( 
"ALTER TABLE Crime ADD COLUMN suspect TEXT NOT NULL DEFAULT ''" 


由 于 数据 库 初 始 版 本 是 1， 因 此 现在 修改 为 2。 然 后 创建 一 个 Migration 
对 象 更 新 数据 库 。 


Migration 克 构造 函数 需要 两 个 参数 ， 第 一 个 是 迁移 前 的 数据 库 版 本 ， 
第 二 个 是 迁移 到 的 版 本 。 这 里 就 是 版 本 写 1 和 2。 


Migration 对 象 里 唯一 需要 实现 的 函数 

ee M 使 用 database 参 数 ， 可 以 执行 
任何 升级 数据 库 表 的 SQL 命 令 ( 第 11 章 讲 过 ，Room 的 后 台 支 持 是 
ee 这 里 的 ALTER TABLE 命令 就 是 把 嫌疑 人 字段 添加 到 crime 数 
据 库 表 里 。 


创建 了 Migration 后 ， 需 要 把 它 提 交 给 数据 库 。 打 开 
CrimeRepository.kt， 在 创建 CrimeDatabase 实 例 时 ， 把 Migration 添 加 
给 Room， 如 代码 清单 15-5 所 示 。 


代码 清单 15-5 ”把 Migration 添 加 给 Room (CrimeRepository.kt) 


class CrimeRepository private constructor(context: Context) { 


private val database : CrimeDatabase = Room.databaseBuilder( 
context.applicationContext, 
CrimeDatabase::class.java, 
DATABASE NAME 


— —kHbuildO 


).addMigrations(migration 1 2) 
.build() 
private val crimeDao = database.crimeDao() 


调用 build() 函 数 之 前 ， 首 先 调用 addMigrations(...) 创 建 数据 库 迁 
f£. addMigrations(...) KRAZ% Migration REM, (Kab) 
把 声明 好 的 多 个 addMigrations(...) 全 部 传 给 它 。 


当 应 用 局 动 ，Room 创 建 数据 库 时 ， 它 会 检查 设备 上 现 有 数据 库 的 版 
本 。 如 果 检 查 到 的 版 本 和 定义 在 @Database 注 解 里 的 不 一 样 ，Room 会 找 
到 合适 的 Migration 以 更 新 数据 库 到 最 新 版 本 。 


为 数据 库 转换 提供 迁移 很 重要 。 如 果 不 提 供 ，Room 则 会 先 删 除 旧 版 本 
ue. 再 创建 新 版 本 数据 库 。 这 意味 着 数据 会 全 部 丢失 ， 用 户 肯定 会 


数据 库 迁 移 准备 好 后 ， 可 以 运行 CriminalIntent 应 用 看 看 是 否 一 切 正 常 。 
应 用 表现 应 该 和 之 前 一 样 ， 你 会 看 到 第 14 章 中 添加 的 crime 数 据 。 稍 
后 ， 我 们 就 来 使 用 新 加 的 数据 库 栏 位 。 


15.3 ”使 用 格式 化 字符 串 


最 后 一 项 准备 工作 是 创建 消息 模板 。 应 用 运行 前 ， 我 们 无 法 获知 有 具体 的 
陋习 细 市 。 因 此 ， 必 须 使 用 带 有 占 位 符 〈 可 在 应 用 运行 时 玲 换 ) 的 格式 
化 字符 串 。 下 面 是 得 用 的 格式 化 字符 串 : 


%1$s! The crime was discovered on X2$s. %3$s, and %4$s 


%1$s、%2$s 等 特殊 字符 串 是 占 位 符 ， 它 们 接受 字符 串 参 数 。 在 代码 
中 ， 我 们 将 调用 getSstring(...) 函 数 ， 并 传 入 格式 化 字符 串 资 源 ID 以 
BFS FET BEB (BBS HIN ATT BO) 。 

首先 ， 在 strings.xml 中 ， 添 加 如 代码 清单 15-6 所 示 的 字符 串 资 源 。 


代码 清单 15-6 ”还 加 字符 串 资 源 (res/values/strings.xml ) 


<resources> 


<string name="crime_suspect_text">Choose Suspect</string> 
<string name="crime_report_text">Send Crime Report</string> 
«string name="crime_report">%1$s! 

The crime was discovered on %2$s. %3$5, and %4$s 
«/string» 


«string name-"crime report solved"»The case is solved«/string» 
«string name-"crime report unsolved"»The case is not solved</string> 
«string name-"crime report no suspect"»there is no suspect.</string> 
«string name-"crime report suspect"»the suspect is %s.</string> 
«string name-"crime report subject"»CriminalIntent Crime Report</string 
«string name-"send report"»Send crime report via«/string» 

</resources> 


Ka, fECrimeFragment.ktF, ZsHgetCrimeReport()r&Z&, fi EVO EZ 
字符 串 信 息 ， 并 返回 拼接 完整 的 消息 ， 如 代码 清单 15-7 所 示 。 


代码 清单 15-7 ”新 增 getCrimeReport() 方 函数 
(CrimeFragment.kt ) 


private const val REQUEST DATE = 6 
private const val DATE FORMAT = "EEE, MMM, dd" 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private fun updateUI() ( 


} 


private fun getCrimeReport(): String { 
val solvedString = if (crime.isSolved) { 
getString(R.string.crime_report_solved) 
} else { 
getString(R.string.crime_report_unsolved) 


} 


val dateString = DateFormat. format(DATE_FORMAT, crime.date).toStrin 
var suspect = if (crime.suspect.isBlank()) ( 
getString(R.string.crime_report_no_suspect) 
} else { 
getString(R.string.crime_report_suspect, crime.suspect) 


} 


return getString(R.string.crime_report, 


crime.title, dateString, solvedString, suspect) 


} 


companion object { 


} 
} 


(注意 ，DateFormat 类 有 多 个 ， 我 们 要 用 的 
是 android.text.format.DateFormat。) 


至 此 ， 准 备 工作 全 部 完成 了 ， 接 下 来 学 习 如 何 使 用 隐 陈 intent。 


15.4 ”使 用 隐 式 intent 


Intent 对 销 用 来 向 操作 系统 说 明 需 要 处 理 的 任务 。 使 用 显 式 intent 时 ， 
我 们 需要 指定 让 操作 系统 启动 的 activity。 下 面 是 之 前 创建 过 的 显 式 


intent: 


val intent = Intent(this, CheatActivity::class.java) 


startActivity(intent) 


使 用 隐 式 intent 时 ， 只 需 告诉 操作 系统 你 想 要 做 什么 ， 操 作 系 统 就 会 去 
启动 能 够 胜任 工作 任务 的 activity。 如 果 找 到 多 个 符合 的 activity， 用 户 会 
看 到 一 个 可 选 应 用 列表 ， 然 后 就 看 用 户 如 何 选择 了 。 

15.4.1 [了 绚 式 intent 的 组 成 

下 面 是 隐 式 intent 的 主要 组 成 部 分 ， 可 以 用 来 定义 你 想 做 的 事 。 

(1) 要 执行 的 操作 

通常 以 Intent 类 中 的 常量 来 表示 。 例 如 ， 要 访问 某 个 URL， 可 以 使 
HjIntent.ACTION VIEW; 要 发 邮件 ， 可 以 使 

用 Intent.ACTION_SEND。 

(2) 待 访问 数据 的 位 置 

这 可 能 是 设备 以 外 的 资源 ， 比 如 某 个 网 页 的 URL， 也 可 能 是 指向 某 个 文 


件 的 URI， 或 者 是 指向 ContentProvider 中 某 条 记录 的 某 个 内 容 
URI (content URI) 。 


(3) 操作 涉及 的 数据 类 型 


这 指 的 是 MIME 形 式 的 数据 类 型 ， 比 如 texthtml 或 audio/mpeg3。 如 果 一 
个 intent 包 含 数据 位 置 ， 那 么 通常 可 以 从 中 推测 出 数据 的 类 型 。 


(4) 可 选 类 别 


操作 用 于 描述 具体 要 做 什么 ， 而 类 别 通 常用 来 描述 你 打算 何 时 、 何 地 或 
者 如 何 使 用 某 个 activity。 例 如 ，Android 的 
android.intent.category.LAUNCHER 类 别 表明 ，activity 应 该 显示 在 
顶级 应 用 启动 器 中 ; 而 android.intent.category.INFO0 类 别 表 明 ， 
虽然 activity 同 用 户 显 示 了 包 人 信息， 但 它 不 应 该 出 现在 启动 器 中 。 


所 以 ， 举 个 例子 ， 一 个 查看 某 个 网 址 的 简单 隐 式 intent 会 包括 一 
Intent .ACTION_VIEW 操 作 ， 以 及 某 个 具体 UREL 网 址 的 Uri 数 据 。 


基于 以 上 信息 ， 操 作 系统 将 局 动 适用 的 activity。 《如果 有 多 个 应 用 适 
用 ， 则 用 户 自 己 选择 。) 


通过 配置 文件 中 的 intent 过 滤器 设置 ，activity 会 对 外 宣称 自己 适合 处 
理 ACTION_VIEW。 例 如 ， 如 果 想 开发 一 球 浏 览 器 应 用 ， 为 了 响应 
ACTION_VIEW 操 作 ， 你 会 在 activity 声 明 中 包含 以 下 intent 过 滤器 : 


<activity 
android:name-".BrowserActivity" 
android: label="@string/app_name" > 
<intent-filter> 


<action android:name="android.intent.action.VIEW" /> 
«category android:name="android.intent.category.DEFAULT" /> 
«data android:scheme-"http" android:host="www.bignerdranch.com" /> 
</intent-filter> 
</activity> 


为 啊 应 隐 式 intent， 必 须 在 intent 过 滤器 中 明确 设置 activity 的 DEFAULT 类 

别 。action 元 素 告 诉 操 作 系 统 ，activity 能 够 胜任 指定 任务 。DEFAULT 类 
别 告诉 操作 系统 ( 问 谁 可 以 做 时 ) ，activity 愿 意 处 理 某 项 任 

务 。DEFAULT 类 别 实际 隐 伟 添加 给 了 几乎 所 有 隐 式 intent。 (当然 也 有 例 


外 ， 详 见 第 23 章 。) 


和 显 式 intent 一 样 ， 隐 式 intent 也 可 以 包含 extra 信 息 。 不 过 ， 操 作 系 统 在 
寻找 适用 的 activity 时 ， 不 会 使 用 附加 在 隐 式 intent 上 的 任何 extra。 


注意 ， 显 式 intent 也 可 以 使 用 隐 式 intent 的 操作 和 数据 部 分 。 这 相当 于 要 
求 特 定 的 activity 去 做 特定 的 事 。 


15.4.2 ”发 送 消息 


在 CriminalIntent 应 用 中 ， 通 过 创建 发 送 消息 的 隐 式 intent， 我 们 来 看 看 它 
是 如 何 工 作 的 。 消 息 是 由 字符 串 组 成 的 文本 信息 ， 我 们 的 任务 是 发 送 一 
段 文本 信息 ， 因 此 隐 式 intent 的 操作 是 ACTION_SEND。 它 不 指 同 任何 数 
据 ， 也 不 包含 任何 类 别 ， 但 会 指定 数据 类 型 为 text/plain。 


在 CrimeFragment.onCreateView(...) 函 数 中 ， 首 先 以 资源 ID 引 用 
SEND CRIME REPORT 按 钮 并 为 其 设置 一 个 监听 器 。 然 后 在 监听 响 接 口 
实现 中 ， 创 建 一 个 隐 式 intent 并 传 入 startActivity(Intent) 函 数 ， 如 
代码 清单 15-8 所 示 。 


代码 清单 15-8 发送 消息 (CrimeFragment.kt ) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private lateinit var solvedCheckBox: CheckBox 
private lateinit var reportButton: Button 


override fun onCreateView( 

): View? { 
dateButton - view.findViewById(R.id.crime date) as Button 
solvedCheckBox = view.findViewById(R.id.crime solved) as CheckBox 


reportButton - view.findViewById(R.id.crime report) as Button 


return view 


} 
override fun onStart() { 


dateButton.setOnClickListener { 


} 


reportButton.setOnClickListener { 
Intent(Intent.ACTION SEND).apply { 
type = "text/plain" 
putExtra(Intent.EXTRA TEXT, getCrimeReport() ) 
putExtra( 
Intent.EXTRA SUBJECT, 
getString(R.string.crime report subject)) 
).also { intent -> 
startActivity(intent) 


以 上 代码 使 用 了 一 个 接受 字符 串 参 数 的 Intent 构 造 函 数 ， 我 们 传 入 的 
是 一 个 定义 操作 的 常量 。 取 决 于 要 创建 的 隐 式 intent 类 别 ， 还 有 一 些 其 


他 形式 的 构造 函数 可 用 。 可 以 查阅 Intent 参 考 文档 进一步 了 解 。 因 为 
没有 接受 数据 类 型 的 构造 函数 可 用 ， 所 以 必须 专门 设置 它 。 


消息 内 容 和 主题 是 作为 extra 附 加 到 intent 上 的 。 注 意 ， 这 些 extra 信 息 使 
用 了 Intent 类 中 定义 的 常量 。 因 此 ， 任 何 响应 该 intent 的 activity 都 知道 
这 些 和 常量 ， 自 然 也 知道 该 如 何 使 用 它们 的 关联 值 。 


从 fragment 启 动 activity 和 从 activity 启 动 activity 的 工作 原理 没 多 大 差别 。 
你 调用 Fragment 的 startActivity(Intent) 函 数 ， 该 函数 在 后 台 再 调 
用 相应 的 Activity 函 数 。 


运行 CriminalIntent 应 用 并 点 击 SEND CRIME REPORT 按 钮 。 因 为 刚 创建 
的 intent 会 匹配 设备 上 的 许多 activity， 所 以 你 很 可 能 会 看 到 长 长 的 候选 
activity 列 表 ， 如 图 15-2 所 示 。 


Share with 
o Bluetooth 
ÍT] Copy to clipboard 
M Gmail 
Messages 


&  Saveto Drive 


图 15-2 文 持 发 送 消 息 的 全 部 activity 


从 列表 中 做 出 选择 后 ， 可 以 看 到 消 奶 加 载 到 了 所 选 应 用 中 。 接 下 来 ， 只 
需 填 入 地 址 ， 点 击发 送 即 可 。 


注意 ， 像 Gmail 和 Google Drive 这 样 的 应 用 需要 Google 账 号 才能 登录 。 所 
以 ， 选 择 不 用 登录 的 短 消 恩 应 用 会 简单 一 些 。 在 Select conversation®} i& 
框 窗口 中 ， 点 击 New message， 然 后 输入 电话 号 码 ， 再 点 击 如 图 15-3 所 
示 的 “发 送 到 指定 号 码 ” 标 签 。 可 以 看 到 ， 要 发 送 的 消 恩 已 经 置 入 短 消 轧 
窗口 。 


Select conversation 


Once you start a new 
conversation, youl see it listed 
here 


Cancel New message 


90 Yl 
€ New conversation 

To — 886655988 a 
人 omsms 


(B8 oe - 3 
qwertyuiop 
asdfghjkl 
O7xXxcvbam@ 


"go »s .( 


图 15-3 f FH RU BVA SS 


然而 ， 有 时 可 能 看 不 到 候选 activity 列 表 。 出 现 这 种 情况 通常 有 两 个 原 
因 : 要 么 是 针对 某 个 隐 式 intent 设 置 了 默认 响应 应 用 ， 要 么 是 设备 上 仪 
有 一 个 activity 可 以 响应 隐 式 intent。 


9:00 Al 
G LQ} 
To 5858555585 " 
$33pM 
Conversation wth (368) 55-4855 
dirty dishes in break room! The 
crime was discovered on Fri, 


60 May, 10, The case is solved, and 5 
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通常 ， 对 于 某 项 操作 ， 最 好 使 用 用 户 的 默认 应 用 。 不 过 ， 在 
CriminalIntent 应 用 中 ， 针 对 ACTION_SEND 操 作 ， 应 该 总 是 将 选择 权 交 给 
用 户 。 要 知道 ， 也 许 今 天 用 户 想 低调 处 理 问题 ， 只 采取 邮件 的 形式 发 送 
陋习 报告 ， 而 明天 就 改变 主意 了 : 更 希望 通过 Twitter 公开 择 击 那些 公共 
场所 的 陋习 。 


使 用 隐 式 intent 局 动 activity 时 ， 也 可 以 创建 每 次 都 显示 的 activity 选 择 


器 。 和 以 前 一 样 ， 创 建 隐 式 intent 后 ， 调 用 以 下 Intent 函 数 并 传 入 创建 
的 隐 式 intent 以 及 用 作 选择 右 标题 的 字符 串 : 


Intent.createChooser(Intent, String) 


然后 ， 将 createChooser(...) 函 数 返 回 的 intent 传 
入 startActivity(...) 函 数 。 


在 CrimeFragment.kt 中 ， 创 建 一 个 选择 器 显示 啊 应 隐 式 intent 的 全 部 
activity， 如 代码 清单 15-9 所 示 。 


代码 清单 15-9 使 用 选择 器 〈CrimeFragment.kt ) 


reportButton.setOnClickListener { 
Intent (Intent.ACTION_SEND).apply { 
type = "text/plain" 
putExtra(Intent.EXTRA_TEXT, getCrimeReport() ) 
putExtra( 
Intent.EXTRA SUBJECT, 
getString(R.string.crime report subject)) 
).also { intent -> 


a RIET TE 


val chooserIntent = 
Intent.createChooser (intent, getString(R.string.send_report 
startActivity(chooserIntent) 


运行 CriminalIntent 应 用 并 点 击 SEND CRIME REPORT 按 钮 。 可 以 看 到 ， 
只 要 有 多 个 activity 可 以 处 理 隐 式 intent， 就 会 得 到 一 个 候选 activity 列 
表 ， 如 图 15-4 所 示 。 


Send crime report via 


oouo-™ © 


Bluetooth Copy to Gmail 


clipboard 


Save to Drive 


图 15-4 通过 选择 器 选择 应 用 发 送 消息 
15.43 ”获取 联系 人 信息 


现在 ， 创 建 另 一 个 隐 式 intent， 让 用 户 从 联系 人 应 用 里 选择 嫌疑 人 。 这 
个 隐 式 intent 将 由 操作 以 及 数据 获取 位 置 组 成 。 操 作 

为 Intent.ACTION_PICK。 联 系 人 数据 获取 位 置 

为 ContactsContract.Contacts .CONTENT_URI。 简 而 言 之 ， 就 是 请 
Android 从 联系 人 数据 库 里 获取 某 个 具体 联系 人 。 


因为 要 获取 启动 activity 的 返回 结果 ， 所 以 我 们 调 

用 startActivityForResult(...) 函 数 并 传 入 intent 和 请 求 代码 。 在 
CrimeFragment.kt 中 ， 新 增 请 求 代 码 常 量 和 按钮 成 员 变 量 ， 如 代码 清单 
15-10 所 示 。 


代码 清单 15-10 ”添加 嫌疑 人 按钮 成 员 变 量 〈CrimeFragment.kt) 


private const val REQUEST DATE = 6 
private const val REQUEST CONTACT = 1 
private const val DATE FORMAT = "EEE, MMM, dd" 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private lateinit var reportButton: Button 
private lateinit var suspectButton: Button 


在 onCreateView(...) 函 数 的 末尾 ， 引 用 新 增 按钮 。 在 onSstart() 郴 
数 中 ， 为 其 设置 监听 器 。 在 监听 器 接口 实现 中 ， 创 建 一 个 隐 式 intent 并 
传 入 startActivityForResult(...) 函 数 。 最 后 ， 如 果 找 到 联系 人 ， 
就 将 其 名 字 显 示 在 按钮 上 ， 如 代码 清单 15-11 所 示 。 


代码 清单 15-11 ”发送 隐 式 intent (CrimeFragment.kt) 


class CrimeFragment : Fragment()，DatePickerFragment.Callbacks { 


override fun onCreateView( 
): View? { 


reportButton = view.findViewById(R.id.crime report) as Button 
suspectButton = view.findViewById(R.id.crime_suspect) as Button 


return view 


} 


override fun onStart() ( 
reportButton.setOnClickListener { 


} 


suspectButton.apply { 
val pickContactIntent = 
Intent(Intent.ACTION_PICK, ContactsContract.Contacts.C 


setOnClickListener { 
startActivityForResult(pickContactIntent, REQUEST_CONTACT) 


稍 后 还 会 使 用 pickContactIntent， 这 里 没有 将 它 放 
在 OnClLickListener 监 听 器 代码 中 。 


接 下 来 ， 修 改 updateUI()， 如 果 能 找到 crime 事 件 嫌疑 人 ， 就 在 
CHOOSE SUSPECT 按 钮 上 显示 他 的 名 字 ， 如 代码 清单 15-12 所 示 。 


代码 清单 15-12 设置 按钮 文字 (CrimeFragment.kt) 


private fun updateUI() { 
titleField.setText(crime.title) 
dateButton.text = crime.date.toString() 
solvedCheckBox.apply { 
isChecked = crime.isSolved 


jumpDrawablesToCurrentState() 


} 
if (crime.suspect.isNotEmpty()) { 
suspectButton.text = crime.suspect 


} 


运行 CriminalIntent 应 用 并 点 击 CHOOSE SUSPECT 按 钮 ， 应 该 能 看 到 一 
个 类 似 图 15-5 所 示 的 联系 人 列表 。 


9:00 *A8 


€ Choose a contact Q 


B [B] Bill Phillips 


Brian Gardner 


c @ Chris Stewart 
« @ 


Kristin Marsicano 


图 15-5 包含 嫌疑 人 的 联系 人 列表 


注意 ， 如 果 设 备 上 安装 了 其 他 联系 人 应 用 ， 应 用 界面 可 能 会 有 所 不 同 。 
另外 可 以 看 到 ， 从 当前 应 用 中 调用 联系 人 应 用 时 ， 完 全 不 用 知道 应 用 的 
ANS 用 户 可 以 安装 任何 喜爱 的 联系 人 应 用 ， 操 作 系 统 会 负责 找 
到 并 启动 它 。 


01. 从 联系 人 列表 中 获取 联系 人 数据 


现在 ， 需 要 从 联系 人 应 用 中 获取 返回 结果 。 很 多 应 用 都 会 共享 联系 
人 信息 ， 因 此 Android 提 供 了 一 个 深度 定制 的 API 用 于 处 理 联系 人 信 
A: ContentProvider 类 。 该 类 的 实例 封装 了 联系 人 数据 库 并 提 
供给 其 他 应 用 使 用 。 我 们 可 以 通过 ContentResolver 访 问 
ContentProvider. (联系 人 数据 库 是 一 个 比较 复杂 的 主题 ， 这 
里 不 会 展开 讨论 。 如 需 详细 了 解 ， 可 以 阅读 Content Provider API 指 


Bj. ) 

前 面 ， 我 们 以 ACTION_PICK 启 动 了 activity 并 要 求 返 回 结果 ， 因 此 调 
用 onActivityResult(...) 函 数 会 接收 到 一 个 intent。 该 intent 包 括 
了 数据 URI。 这 个 URI 是 个 数据 定位 符 ， 指 向 用 户 所 选 的 联系 人 。 


在 CrimeFragment.kt 中 ， 实 现 onActivityResult(...) 函 数 ， 从 联 
系 人 应 用 里 获取 联系 人 名 字 ， 如 代码 清单 15-13 所 示 。 


代码 清单 15-13 ”获取 联系 人 姓名 (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private fun updateUI() { 


} 


override fun onActivityResult(requestCode: Int, resultCode: Int, d 
when { 
resultCode != Activity.RESULT OK -> return 


requestCode == REQUEST CONTACT && data != null -> { 
val contactUri: Uri? = data.data 
// Specify which fields you want your query to return 
val queryFields = arrayOf(ContactsContract.Contacts.DI 
// Perform your query - the contactUri is like a "wher 
val cursor = requireActivity().contentResolver 
.query(contactUri, queryFields, null, null, null) 
cursor?.use ( 
// Verify cursor contains at least one result 
if (it.count == 0) { 
return 


} 


// Pull out the first column of the first row of d 
// that is your suspect's name 

it.moveToFirst() 

val suspect = it.getString(0) 

crime.suspect = suspect 
crimeDetailViewModel.saveCrime(crime) 
suspectButton.text - suspect 


D» 


以 上 代码 创建 了 一 条 查询 语句 ， 要 求 返 回 全 部 联系 人 的 名 字 。 然 后 
查询 联系 人 数据 库 ， 获 得 一 个 可 用 的 Cursor。 因 为 已 经 知 

道 Cursor 只 包含 一 条 记录 ， 所 以 将 Cursor 移 动 到 第 一 条 记录 并 获 
取 它 的 字符 串 形式 。 该 字符 串 即 为 嫌疑 人 的 姓名 。 然 后 ， 用 它 设 
置 Crime 嫌 疑 人 ， 并 显示 在 CHOOSE SUSPECT 按 钮 上 。 


一 旦 取 到 嫌疑 人 数据 ，crime 记 录 束 需要 再 次 保存 到 数据 库 里 。 这 
么 做 的 原因 有 点 微妙 。 在 CrimeFragment 继 续 运 行 

时 ，onViewCreated(...) 函 数 会 被 调用 ， 这 会 从 数据 库 得 询 当 前 
处 理 的 crime 记 录 。 但 onActivityResult(...) 又 是 

在 onViewCreated(...) 函 数 之 前 被 调用 ， 所 以 ， 再 次 取出 的 crime 
记录 会 覆盖 带 嫌 疑 人 信息 的 记录 。 为 避免 丢失 嫌疑 人 数据 ， 你 就 得 
及 时 把 带 嫌 疑 人 数据 的 crime 记 录 写 入 数据 库 。 


现在 ， 完 整 信 息 应 该 稳妥 保存 在 数据 库 里 了 。CrimeFragment 还 是 
会 取 到 旧 crime 记 录 ， 但 数据 更 新 一 完成 ，LiveData 就 会 及 时 通知 
到 你 。 


稍 后 ， 你 会 运行 CriminalIntent 应 用 。 运 行 前 ， 先 确认 你 的 设备 上 有 
联系 人 应 用 。 如 果 没 有 ， 请 使 用 Android 虚 拟 设备 。 如 果 正 在 使 用 
虚拟 设备 ， 运 行 CriminalIntent 应 用 前 ， 记 得 先 打 开 联 系 人 应 用 添加 
一 些 联系 人 信息 。 


挑选 一 个 嫌疑 人 ， 他 的 名 字 出 现在 了 CHOOSE SUSPECT 按 钮 上 。 
再 尝试 发 送 crime 事 件 消 息 ， 嫌 疑 人 名 字 同 样 会 出 现在 消息 内 容 
里 ， 如 图 15-6 所 示 。 


9.00 9:00 * 41 
Criminallntent € LQ} 
(0 

sii To | 5555555555 " 

dirty dishes in break room 

DETAILS 

FRI MAY 10 14:54:54 EDT 2019 cm 
Solved Conversation with (555) 555-5555 
eem dirty dishes in break room! The 
crime was discovered on Fri, 
SEND CRIME REPORT May, 10, The case is solved, and 5 

the suspect is Bill Phillips! ye 


‘ / 


d 


t 


1123 


1— 4 oe 74 S o 2 8 
qwertyuiop 


Q gw B «4 


9 1 


sdfghjkl 


zXxCcvbnm à 


50 ae 0 


图 15-6 ”嫌疑 人 名 字 出 现在 按钮 和 消息 内 容 里 


02. 联系 人 信息 使 用 权限 


读 取 联系 人 数据 库 的 权限 是 如 何 获取 的 呢 ? 实 际 上 ， 这 是 联系 人 应 
用 将 其 权限 临时 赋予 了 我 们 。 联 系 人 应 用 拥有 使 用 联系 人 数据 库 的 
全 部 权限 。 联 系 人 应 用 返回 包含 在 intent 中 的 URI 数 据 给 父 activity 

时 ， 会 添加 一 个 Intent.FLAG_GRANT_READ_URI_PERMISSION 标 

志 。 该 标志 告诉 Android，CriminalIntent 应 用 中 的 父 activity 可 以 使 

用 联系 人 数据 一 次 。 这 很 有 用 ， 因 为 你 不 需要 访问 整个 联系 人 数据 
库 ， 只 要 访问 其 中 的 一 条 联系 人 信息 就 可 以 了 。 


15.4.4 ”检查 可 啊 应 任务 的 activity 


本 章 创 建 的 第 一 个 隐 式 intent 总 是 会 以 某 种 方式 得 到 啊 应 ， 因 为 就 算 没 
有 可 用 的 消息 发 送 应 用 ， 至 少 还 会 出 现 一 个 应 用 选择 器 : 但 第 二 个 就 不 
ds 因为 有 些 设备 上 根本 没有 联系 人 应 用 。 如 果 操 作 系 统 找 不 到 匹 
配 的 activity， 应 用 束 会 朋 误 。 


解决 办 法 是 首先 通过 操作 系统 中 的 PackageManager 类 进行 自 检 。 
在 onStart() 消 数 中 实现 检查 ， 如 代码 清单 15-14 所 示 。 


代码 清单 15-14 检查 是 否 存在 联系 人 应 用 (CrimeFragment.kt) 


override fun onStart() { 


suspectButton.apply { 
val pickContactIntent = 
Intent(Intent.ACTION PICK, ContactsContract.Contacts.CONTENT UR 


setOnClickListener ( 
startActivityForResult(pickContactIntent, REQUEST CONTACT) 


} 


val packageManager: PackageManager = requireActivity().packageManag 
val resolvedActivity: ResolveInfo? - 
packageManager.resolveActivity(pickContactIntent, 
PackageManager.MATCH DEFAULT ONLY) 
if (resolvedActivity -- null) ( 


isEnabled = false 


ee ur n PackageManager 
全 都 知道 。《〈 本 书后 续 章 节 还 会 介绍 更 多 组 件 。 

用 resolveActivity(Intent，Int) 函 数 ， A PERITUS RE Intent 
任务 的 activity。 flag 标 志 MATCH_DEFAULT_ONLY 限 定 只 搜索 

市 CATEGORY_ DEFAULT 标 志 的 activity。 这 和 startActivity(Intent) 
函数 类 似 。 


E a 它 会 返回 ResolveInfo 各 诉 我 们 找到 了 哪个 activity; 如 
果 找 不 到 ， 必 须 禁 用 嫌疑 人 按钮 ， 否 则 应 用 就 会 朋 溃 。 


如 果 想 验证 过 滤器 ， 但 手头 义 没 有 不 带 联系 人 应 用 的 设备 ， 可 临时 添加 
额外 的 类 别 给 intent。 这 个 类 别 没有 实际 的 作用 ， 只 是 阻止 任何 联系 人 
应 用 和 你 的 intent 匹 配 。 过 滤器 验证 代码 如 代码 清单 15-15 所 示 。 


代码 清单 15-15 ”过 滤器 验证 代码 CCrimeFragment.kt) 


override fun onStart() { 


suspectButton.apply { 


pickContactIntent.addCategory(Intent.CATEGORY HOME) 
val packageManager: PackageManager = requireActivity().packageManag 


现在 ， 再 次 运行 CriminalIntent 应 用 ， 你 应 该 会 看 到 嫌疑 人 选取 按钮 被 禁 
用 了 ， 如 图 15-7 所 示 。 
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图 15-7 嫌疑 人 选取 按钮 已 禁用 
验证 完毕 ， 记 得 删除 相关 代码 ， 如 代码 清单 15-16 所 示 。 
代码 清单 15-16 ”删除 验证 代码 (CrimeFragment.kt) 


override fun onStart() { 


suspectButton.apply { 


— —pieckcentactintent.addCategorPy(Intent.CATEGORY—HOME) 


val packageManager: PackageManager - requireActivity().packageManag 


| 


15.5 HRAJ: 又 一 个 隐 式 intent 


相 较 于 发 送 消息 ， 惯 经 的 用 户 可 能 更 倾 癌 于 直接 贡 问 陋习 嫌疑 人 。 新 增 
一 个 按钮 ， 允 许 用 户 直 接 拨打 陋习 嫌疑 人 的 电话 。 

要 完成 这 个 挑战 ， 首 先 需 要 联系 人 数据 库 中 的 手机 号 码 。 这 需要 查询 

ContactsContract 数 据 库 中 的 CommonDataKinds .Phone 表 。 如 何 查 
询 ， 请 查看 它们 的 参考 文档 。 


小 提示 : 你 应 该 使 用 android.permission.READ_CONTACTS 权 限 。 这 
是 一 个 运行 时 权限 ， 所 以 你 需要 明确 向 用 户 提 请 授权 访问 联系 人 信息 。 


利用 这 个 权限 ， 可 以 查询 到 ContactsContract .Contacts. ID， 然 后 
用 它 查 询 CommonDataKinds .Phone 表 。 


搞定 了 电话 号 码 ， 可 以 使 用 电话 URI 创 建 一 个 隐 式 intent: 


Uri number = Uri.parse("tel:5551234"); 


与 打 电 话 相 关 的 Intent 操 作 有 两 种 : Intent.ACTION_DIAL 和 
Intent.ACTION _CALL。ACTION_CALL 直 接 调 出 手机 应 用 并 拨打 来 自 
intent 的 电话 号 码 ; ACTION_DIAL 则 拨 好 电话 号 码 ， 然 后 等 用 户 发 起 通 
ii. 


推荐 使 用 ACTION_DIAL 操 作 。 这 样 的 话 ， 用 户 就 有 了 冷静 下 来 改变 主意 
的 机 会 。 这 种 贴心 的 设计 应 该 会 受到 欢迎 的 。 


第 16 章 使 用 intent 拍 照 


掌握 了 隐 式 intent 之 后 ， 可 以 考虑 进一步 丰富 crime 记 录 细 节 。 例 如 ， 给 
陋习 现场 拍 张 照片 就 是 个 不 错 的 主意 。 拍 照 需要 用 到 一 些 包 括 隐 式 
intent 在 内 的 新 工具 。 


隐 式 intent 可 以 月 动用 户 喜 爱 的 相机 应 用 并 接收 它 拍 摄 的 照片 。 接 收 到 
照片 后 ， 该 如 何 存储 和 展示 这 些 照片 呢 ? 答案 就 在 本 章 。 


16.1 布置 照片 


首先 要 做 的 是 在 用 户 界面 上 布置 照片 。 这 需要 新 增 两 个 View 对 象 : 显示 
照片 缩 略图 的 ImageView 和 拍照 按钮 。 完 成 后 的 UI 如 图 16-1 所 示 。 
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图 16-1 重新 布置 的 UI 


如 采 在 同一 行 放置 照 族 缩 略图 和 担 照 按钮 ， 应 用 界面 就 会 显得 拥挤 ， 给 
人 不 专业 的 感觉 。 下 面 就 来 合理 地 布置 这 两 个 视图 。 


参照 代码 清单 16-1， 把 新 视图 放 入 res/layout/fragment_crime.xml 布 局 。 


从 左手 边 开 始 ， 首 先 添加 ImageView 视 图 用 来 显示 照片 ， 再 添 
加 ImageButton 视 图 用 来 拍照 。 


代码 清单 16-1 添加 新 部 件 〈res/layoutfragment_crime.xml) 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
Pc 


«LinearLayout 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 


android:orientation-"horizontal" 
android:layout marginStart-"16dp" 
android:layout marginTop-"16dp"» 


«LinearLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content 
android:orientation-"vertical"» 


«ImageView 
android:id-"(jid/crime photo" 
android:layout width-"80dp" 
android:layout height-"80dp" 
android:scaleType-"centerInside 
android:cropToPadding-"true" 
android: background="@android:color/darker_gray"/> 


<ImageButton 
android:id-"(jid/crime camera" 
android:layout width-z"match parent" 
android:layout height-"wrap content" 
android: src="@android: drawable/ic_menu_camera"/> 
</LinearLayout> 
</LinearLayout> 


<TextView 
style="?android: listSeparatorTextViewStyle" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: text="@string/crime_title_label"/> 


</LinearLayout> 


然后 ， 从 右手 边 开 始 ， 把 TextView 标 题 栏 和 EditText 文 字 框 放 入 一 个 
新 LinearLayout 布 局 中 ， 再 安排 其 作为 新 建 LinearLayout 布 局 的 子 布 
局 ， 如 代码 清单 16-2 所 示 。 


代码 清单 16-2 布置 标题 布局 (res/layout/fragment_crime.xml) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
=> 
<LinearLayout 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:orientation="horizontal" 


android: layout_marginStart="16dp" 
android: layout_marginTop="16dp"> 


<LinearLayout 


android: 


android 
android 


</LinearLayout> 


—</tLinearbayeurt> 


<LinearLayout 
android 


android: 
android: 
android: 


<TextView 


layout_width="wrap_content" 


:layout height-"wrap content" 
:orientation-"vertical"» 


:orientation-"vertical" 


layout width-"0Odp" 
layout height-"wrap content" 
layout weight-"1"» 


style-"?android:listSeparatorTextViewStyle" 
android:layout width-z"match parent" 
android:layout height-"wrap content" 
android: text="@string/crime_title_label"/> 


<EditText 


android: id="@+id/crime_title" 

android: layout_width="match_parent" 
android:layout height-"wrap content" 
android:hint-"Qgstring/crime title hint"/» 


</LinearLayout> 
</LinearLayout> 


</LinearLayout> 


运行 CriminalIntent 应 用 


， 点 击 某 个 crime 项 得 看 其 明细 界面 ， 应 该 可 以 看 
到 如 图 16-1 所 示 的 画面 。 


漂亮 的 UI 完成 了 ， 但 要 响应 ImageButton 按 钮 点 击 和 控制 TImageView 视 
图 的 内 容 展示 ， 我 们 还 要 添加 引用 它们 的 属性 。 和 以 前 一 样 ， 调 

用 findViewById(Int) 函 数 从 fragment_crime.xml 布 局 中 找到 相应 视图 
并 使 用 它们 ， 如 代码 清单 16-3 所 示 。 


代码 清单 16-3 ”添加 新 属性 CCrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private lateinit var suspectButton: Button 

private lateinit var photoButton: ImageButton 

private lateinit var photoView: ImageView 

private val crimeDetailViewModel: CrimeDetailViewModel by lazy { 
ViewModelProviders.of(this).get(CrimeDetailViewModel::class.java) 


} 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 


suspectButton - view.findViewById(R.id.crime suspect) as Button 
photoButton = view.findViewById(R.id.crime camera) as ImageButton 
photoView - view.findViewById(R.id.crime photo) as ImageView 


return view 


与 UI 相 关 的 工作 完成 了 。 接 下 来 的 任务 是 编码 实现 拍照 和 显示 照片 功 
能 。 


16.2 文件 存储 


相机 担 摄 的 IU TSIHULMBA 保存 在 SQLite 数 据 库 中 肯定 不 现实 。 
显然 ， 它 们 需要 在 设备 文件 系统 的 茶 个 地 方 保存 。 


很 好 ， 设 备 上 就 有 这 么 一 个 地 方 : 私有 存储 空间 。 还 记得 吗 ? 前 面 ， 我 

们 在 私有 存储 空间 保存 过 SQLite 数 据 文件 。 使 用 类 

(Context. getFileStreamPath(String) fil 

Context. etre (RRA OREN SC PRB AY DIK A 

a 《结果 就 是 照片 文件 保存 在 databases 子 目录 相 邻 的 某 个 子 目录 
a) 


Context 类 提供 的 基本 文件 和 目录 处 理 函 数 如 下 。 


getFilesDir(): File 


获取 /data/data/< 包 名 >/files 目 录 。 


openFileInput(name: String): FileInputStream 
打开 现 有 文件 进行 读 取 。 


openFileOutput(name: String, mode: Int): 
FileOutputStream 


打开 文件 进行 写 入 ， 如 果 不 存在 束 创 建 它 。 


getDir(name: String, mode: Int): File 
获取 /data/data/< 包 名 >/ 目 录 的 子 目 录 〈 如 果 不 存 在 束 先 创建 它 〉。 


fileList(...): Array<String> 


获取 主 文件 目录 下 的 文件 列表 。 可 与 其 他 函数 配合 使 用 ， 比 如 
openFileInput (String). 


getCacheDir(): File 

获取 /data/data/< 包 名 >/cache 目 录 。 应 注意 及 时 清理 该 目录 ， 并 节约 

使 用 。 

有 个 情况 要 说 明 一 下 : 因为 要 处 理 的 照片 都 是 私有 文件 ， 只 有 你 自己 的 

p M 
JV Hr. 


di SR Hw RI E RCE, SSCA fai yo CriminalIntenuV 
FARR Aexx esL: 外 部 相机 应 用 需要 在 你 的 应 用 里 保存 拍摄 的 照片 。 


这 种 情况 下 ， 上 述 函 数 作用 就 有 限 了 。 虽 

然 Context.MODE_WORLD_READABLE 可 以 传 

入 openFileOutput(String，Int) 函 数 ， 但 这 个 flag 已 经 废弃 了 。 即 
使 强制 使 用 ， 在 新 系统 设备 上 也 不 是 很 可 靠 。 以 前 ， 还 可 以 通过 公共 外 
部 存储 转 存 ， 但 出 于 安全 考虑 ， 这 条 路 在 新 版 本 系统 上 也 被 堵 住 了 。 


如 果 想 共享 文件 给 其 他 应 用 ， 或 是 接收 其 他 应 用 的 文件 (比如 相机 应 用 
拍摄 的 照片 ) ， 可 以 通过 ContentProvider 把 要 共享 的 文件 暴露 出 
来 。ContentProvider 人 允许 你 暴露 内 容 URI 给 其 他 应 用 。 这 样 ， 这 些 应 
用 就 可 以 从 内 容 URI 下 载 或 同 其 中 写 入 文件 。 当 然 ， 主 动 权 在 你 手 上 ， 
你 可 以 控制 读 或 写 。 


16.2.1 使 用 FileProvider 


如 果 只 想 从 其 他 应 用 接收 一 个 文件 ， 上 自己 实现 ContentProvider 人 简直 
是 费力 不 讨好 的 事 。Google 早 已 想到 这 点 ， 因 此 提供 了 一 个 名 

为 FileProvider 的 便利 类 。 这 个 类 能 帮 你 搞定 一 切 ， 而 你 只 要 做 做 参 
数 配置 就 行 了 。 


首先 ， 声 明 FileProvider 为 ContentProvider， 并 给 予 一 个 指定 的 权 
限 。 在 AndroidManifest.xml 中 添加 一 个 FileProvider 声 明 ， 如 代码 清 
单 16-4 所 示 。 


代码 清单 16-4 添加 FileProvider 声 明 
(manifests/AndroidManifest.xml ) 


«activity android:name=".MainActivity"> 


</activity> 
<provider 
android: name="androidx.core.content.FileProvider" 
android: authorities="com.bignerdranch.android.criminalintent.filepr 
android: exported="false" 
android: grantUriPermissions="true"> 
</provider> 


这 里 的 权限 是 指 一 个 位 置 : 文件 保存 地 。android:authorities 属 性 
值 在 整个 系统 里 要 有 唯一 性 。 为 了 做 到 这 点 ， 一 个 习惯 做 法 是 在 权限 字 
符 串 里 加 上 应 用 包 名 。 (这 里 用 了 


com.bignerdranch.android.criminalintent， 你 要 是 用 了 不 同 的 包 名 ， 请 目 
行 修改 。) 


把 FileProvider 和 你 指定 的 位 置 关 联 起 来 ， 就 相当 于 你 给 发 出 请 求 的 
其 他 应 用 一 个 目标 地 。 添 加 exported = "false" 属 性 就 意味 着 ， 除 了 
你 目 己 以 及 你 授权 的 人 ， 其 他 任何 人 都 不 允许 使 用 你 的 
FileProvider。 而 grantUriPermissions 必 性 用 来 给 其 他 应 用 授权 ， 
允许 它们 向 你 指定 位 置 的 URI ( 稍 后 你 会 看 到 ， 这 个 位 置信 息 放 在 intent 
HRT Th A HH) ASCH 


既然 已 让 Android 知 道 FileProvider 在 哪 ， 那 么 还 需要 配 

置 FileProvider， 让 它 知 道 该 暴露 哪些 文件 。 这 个 配置 用 另外 一 个 
XML 资源 文件 处 理 。 在 项 目 工具 窗口 ， 右 键 单 击 app/res 目 录 ， 然 后 选择 
New > Android resource file 荣 单项 。 资 源 类 型 选 XML ， 文 件 名 输入 
files， 确 认 并 创建 这 个 文件 。 


打开 刚刚 创建 的 res/xmlMfiles.xzml 文 件 ， 切 换 至 代码 模式 ， 按 代码 清单 16- 
5 蔡 换 原 有 内 容 。 


代码 清单 16-5 ”填写 路 径 描述 (res/xml/files.xml ) 


<paths> 
«files-path name="crime_photos" path="."/> 
</paths> 


这 是 个 描述 性 XML 文件 ， 其 表达 的 意思 是 ， 把 私有 存储 空间 的 根 路 径 
映射 为 crime_photos。 这 个 名 字 仅 供 FileProvider 内 部 使 用 ， 你 不 应 
EAE. 


最 后 ， 在 AndroidManifest.xml 文 件 中 ， 添 加 一 个 meta-data 标 签 ， 让 
FileProvider 能 找到 fies.xml 文 件 ， 如 代码 清单 16-6 所 示 。 


代码 清单 16-6 ”关联 使 用 路 径 描述 资源 


(manifests/AndroidManifest.xml ) 


<provider 
android: name="androidx.core.content.FileProvider" 
android: authorities="com.bignerdranch.android.criminalintent.filepr 
android: exported="false" 


android: grantUriPermissions="true"> 
<meta-data 
android:namez"android.support.FILE PROVIDER PATHS" 
android:resource-z"yXxml/files"/» 
«/provider» 


16.2.2 ”指定 照片 存放 位 置 


现在 要 处 理 的 是 指定 照片 存放 位 置 。 首 先 ， 在 Crime.kt 中 添加 一 个 计算 
属性 获取 图 片 文件 名 ， 如 代码 清单 16-7 所 示 。 


代码 清单 16-7 ”添加 计算 属性 获取 文件 名 〈Crime.kt) 


@Entity 

data class Crime(@PrimaryKey val id: UUID = UUID.randomUUID(), 
var title: String = "", 
var date: Date = Date(), 
var isSolved: Boolean = false, 


var suspect: String = "") { 


val photoFileName 
get() = "IMG $id. jpg" 


photoFileName 不 知道 照片 文件 该 存储 在 哪个 目录 。 不 过 ， 既 然 文件 名 
基于 Crime ID 制 定 ， 它 就 有 具有 了 唯一 性 。 


接 下 来 ， 找 到 要 保存 文件 的 目录 。CrimeRepository 人 负责 CriminalIntent 
应 用 的 数据 持久 化 工作 。 既 然 如 此 ， 那 么 在 CrimeRepository 类 里 添 
加 getPhotoFile(Crime) 函 数 也 惑 再 合适 不 过 了 ， 如 代码 清单 16-8 所 
Ze 


代码 清单 16-8 ”定位 照片 文件 (CrimeRepository.kt) 


class CrimeRepository private constructor(context: Context) { 


private val executor 
private val filesDir 


Executors.newSingleThreadExecutor () 
context.applicationContext.filesDir 


fun addCrime(crime: Crime) { 


} 


fun getPhotoFile(crime: Crime): File = File(filesDir, crime.photoFileNa 


上 述 新 增 函 数 不 会 创建 任何 文件 。 它 的 作用 就 是 返回 指向 某 个 具体 位 置 
的 File 对 象 。 稍 后 ， 我 们 会 使 用 FileProvider 把 路 径 以 URI 的 形式 对 
外 暴露 。 


最 后 ， 在 CrimeDetailViewMode1 类 里 添加 一 个 函数 ， 把 文件 信息 告诉 
CrimeFragment， 如 代码 清单 16-9 所 示 。 


代码 清单 16-9 通过 CrimeDetailViewMode1l 展 示 文 件 信息 
(CrimeDetailViewModel.kt) 


class CrimeDetailViewModel : ViewModel() { 
fun saveCrime(crime: Crime) { 


crimeRepository.updateCrime(crime) 


} 


fun getPhotoFile(crime: Crime): File { 
return crimeRepository.getPhotoFile(crime) 


} 


16.3 ”使 用 相机 intent 


现在 可 以 实现 拍照 功能 了 。 这 并 不 难 ， 只 要 使 用 一 个 隐 式 intent 就 可 以 
了 。 


首先 是 保存 照片 文件 存储 位 置 ， 如 代码 清单 16-10 所 示 。〔 接 下 来 好 几 
个 地 方 会 用 到 它 ， 做 好 这 步 会 省 不 少 事 。) 


代码 清单 16-10 ”获取 照片 文件 位 置 (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private lateinit var crime: Crime 
private lateinit var photoFile: File 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 


crimeDetailViewModel.crimeLiveData.observe( 
viewLifecycleOwner, 
Observer ( crime -> 
crime?.let { 
this.crime - crime 
photoFile = crimeDetailViewModel.getPhotoFile(crime) 
updateUI() 


然后 是 处 理 相机 拍照 按钮 ， 和 触发 拍照 。 相 机 intent 定 义 在 Mediastore 
里 。 这 个 类 负 贡 处 理 所 有 与 多 媒体 相关 的 任务 。 发 送 一 个 

带 MediaSstore.ACTION_IMAGE_CAPTURE 操 作 的 intent，Android 会 局 动 
相机 activity 拍 照 。 


实现 拍照 功能 的 思路 已 经 厘清 了 ， 但 还 有 些小 细节 要 处 理 。 


触及 拍照 


准备 工作 都 已 完成 ， 可 以 使 用 相机 intent 了 。 我 们 需要 的 intent 操 作 是 
义 在 Mediastore 类 中 的 ACTION_IMAGE_CAPTURE。Mediastore 类 定 ^x 
了 一 些 公共 接口 ， 可 用 于 处 理 图 像 、 视 频 以 及 音乐 这 些 常见 的 多 媒体 任 
务 。 当 然 ， 这 也 包括 触发 相机 应 用 的 拍照 intent。 


ACTION_ IMAGE_CAPTURE 打 开 相 机 应 用 ， 默 认 只 能 拍摄 缩 略图 这 样 的 低 
分 辨 率 照片 ， 而 且 照 片 会 保存 在 onActivityResult(...) 返 回 的 
Thtent 对 条 里 。 


要 想 获 得 全 尺寸 照片 ， 就 要 让 它 使 用 文件 系统 存储 照片 。 以 通过 传 


入 保存 在 Mediastore.EXTRA_OUTPUT 中 的 指向 存储 路 径 的 Uri 来 完 
成 。 这 个 Uri 会 指向 FileProvider 提 供 的 位 置 。 


首先 ， 创 建 一 个 新 属性 保存 图 片 URI， 然 后 使 用 引用 到 的 photoFile 初 
始 化 它 ， 如 代码 清单 16-11 所 示 。 
代码 清单 16-11 添加 图 片 URI 属 性 (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private lateinit var crime: Crime 
private lateinit var photoFile: File 
private lateinit var photoUri: Uri 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 


crimeDetailViewModel.crimeLiveData.observe( 
viewLifecycleOwner, 
Observer ( crime -> 
crime?.let { 
this.crime - crime 
photoFile = crimeDetailViewModel.getPhotoFile(crime) 
photoUri - FileProvider.getUriForFile(requireActivity() 
"com.bignerdranch.android.criminalintent.fileprovid 
photoFile) 
updateUI() 


调用 FileProvider.getUriForFile(...) 会 把 本 地 文件 路 径 转换 为 相 
机 能 使 用 的 Uri 形 式 。 该 函数 需要 三 个 参数 来 创建 指 回 图 片 文件 的 

URI: 你 的 activity、provider 授 权 和 图 片 文件 路 径 。 另 外 ， 传 给 
Fileprovider.getUriForFile(...) 的 授权 字符 串 要 和 manifest 文 件 
里 的 相 匹 配 〈 参 见 代 码 清单 16-4) 。 


接 下 来 是 编写 用 于 拍照 的 隐 式 intent， 如 代码 清单 16-12 所 示 。 拍 摄 的 照 
片 应 该 保存 在 photoUri 指 定 的 地 方 。 同 时 ， 别 忘 了 检查 设备 上 是 否 安 
装 有 相机 应 用 ， 以 及 是 否 有 地 方 存储 照片 。《〈 要 确认 是 否 有 可 用 的 相机 
应 用 ， 可 找 PackageManager 确 认 是 否 有 啊 应 相机 隐 式 intent 的 activity。 


关于 查询 PackageManager 的 详细 内 容 ， 参 见 15.4.4 节 。) 


代码 清单 16-12 使 用 相机 intent (CrimeFragment.kt) 


private const val REQUEST CONTACT = 1 
private const val REQUEST PHOTO = 2 
private const val DATE_FORMAT = "EEE, MMM, dd" 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 
ovenrade fun onStart() { 
suspectButtón apply 1 
j ore 


photoButton.apply { 
val packageManager: PackageManager = requireActivity().package 


val captureImage = Intent(MediaStore.ACTION IMAGE CAPTURE) 
val resolvedActivity: ResolveInfo? - 
packageManager.resolveActivity(captureImage, 
PackageManager.MATCH DEFAULT ONLY) 
if (resolvedActivity -- null) ( 
isEnabled - false 
} 


setOnClickListener { 
captureImage.putExtra(MediaStore.EXTRA_OUTPUT, photoUri) 


val cameraActivities: List<ResolveInfo> = 
packageManager.queryIntentActivities(captureImage, 
PackageManager.MATCH DEFAULT ONLY) 


for (cameraActivity in cameraActivities) { 
requireActivity().grantUriPermission( 
cameraActivity.activityInfo.packageName, 
photoUri, 
Intent.FLAG GRANT WRITE URI PERMISSION) 


} 


startActivityForResult(capturelmage, REQUEST PHOTO) 


} 


return view 


S 


要 实际 写 入 文件 ， 还 需要 给 相机 应 用 权限 。 为 了 授权 ， 我 们 授予 
Intent.FLAG GRANT_WRITE_URI_PERMISSION 给 所 有 cameraImage 
intent 的 目标 activity， 以 此 人 允许 它们 在 Uri 指 定 的 位 置 写 文件 。 当 然 ， 还 
有 个 前 提 条 件 : 在 声明 FileProvider 的 时 候 添 加 过 
android:grantUriPermissions 必 性。 


运行 CriminalIntent 应 用 ， 点 击 相机 按钮 启动 相 机 应 用 ， 如 图 16-2 所 示 。 


图 16-2 打开 设备 上 的 相机 应 用 


16.4 缩放 和 显示 位 网 


现在 ， 终 于 可 以 拍摄 陋习 现场 的 照片 并 保存 了 。 


有 了 照片 ， 接 下 来 就 是 找到 并 加 载 它 ， 然 后 展示 给 用 户 看 。 在 技术 实现 
上 ， 这 需要 加 载 照片 到 大 小 合适 的 Bitmap 对 象 中 。 要 从 文件 生 
成 Bitmap 对 象 ， 我 们 需要 BitmapFactory 类 : 


val bitmap = BitmapFactory.decodeFile(photoFile.getPath()) 


看 到 这 里 ， 有 没有 感觉 不 对 劲 ? 肯定 有 的 。 人 否则 依照 本 书 代码 风格 ， 上 
述 代 码 融会 直接 加 粗 印 刷 ， 你 对 照 输入 就 行 了 。 


不 卖 关 子 了 ， 问 题 在 于 ， 介 绍 Bitmap 时 ， 我 们 提 到 “大 小 合 

适 ”。Bitmap 是 个 简单 对 象 ， 它 只 存储 实际 像素 数据 。 也 就 是 说 ， 即 使 
原始 照片 已 压缩 过 ， 但 存 入 Bitmap 对 象 时 ， 文 件 并 不 会 同样 压缩 。 
此 ， 一 张 1600 万 像素 24 位 的 相机 照片 〈 存 为 卫 G 格 式 大 约 5 MB) , 一旦 
载 入 Bitmap 对 象 ， 就 会 立即 膨胀 至 48 MB! 


这 个 问题 可 以 设法 解决 ， 但 需要 手动 缩放 位 图 照片 。 有 具体 做 法 是 ， 首 移 
确认 文件 到 底 有 和 多大， 然后 考虑 按照 给 定 区域 大 小 合理 缠 放 文件 。 最 
后 ， 重 新 读 取 缩放 后 的 文件 ， 创 建 Bitmap 对 象 。 


创建 名 为 PictureUtils.kt 的 新 文件 ， 并 在 其 中 添 
加 getSscaledBitmap(String，Int，Int) 缩 放 函 数 ， 如 代码 清单 16- 
13 所 示 。 


代码 清单 16-13 ”创建 getScaledBitmap(...) 函 数 
( PictureUtils.kt) 


fun getScaledBitmap(path: String, destWidth: Int, destHeight: Int): Bitmap 
// Read in the dimensions of the image on disk 
var options - BitmapFactory.Options() 
options.inJustDecodeBounds = true 
BitmapFactory.decodeFile(path, options) 


val srcWidth = options.outWidth.toFloat() 
val srcHeight - options.outHeight.toFloat() 


// Figure out how much to scale down by 
var inSampleSize - 1 
if (srcHeight » destHeight || srcWidth » destWidth) ( 


val heightScale = srcHeight / destHeight 
val widthScale = srcWidth / destWidth 


val sampleScale = if (heightScale > widthScale) { 
heightScale 

} else { 
widthScale 


inSampleSize = Math.round(sampleScale) 


} 


options = BitmapFactory.Options() 
options.inSampleSize = inSampleSize 


// Read in and create final bitmap 
return BitmapFactory.decodeFile(path, options) 


上 述 函 数 中 ，inSsampleSize 值 很 关键 。 它 决定 着 缩 略 图 像素 的 大 小 。 
如 果 这 个 值 是 1， 就 表明 缩 略 图 和 原始 照片 的 水 平 像素 大 小 一 样 。 如 果 
是 2， 它 们 的 水 平 像 素 比 就 是 1 : 2。 因 此 ，insamplesize 值 为 2 时 ， 缩 
略图 的 像素 数 就 是 原始 文件 的 1/4。 


问题 总 是 接 旺 而 来 。 解 决 了 缩放 问题 ， 又 冒 出 了 新 间 题 : fragment 刚 局 
动 时 ， 没 人 知道 PhotoView 究 竟 有 多 大 。onCreate(...)、onstart() 
和 onResume() 函 数 局 动 后 ， 才 会 有 首 个 实例 化 布局 出 现 。 也 吏 在 此 

时 ， 显 示 在 屏幕 上 的 视图 才 会 有 大 小 尺寸 。 这 也 是 出 现 新 问题 的 原因 。 


解决 方案 有 两 个 : 要 么 等 布局 实例 化 完成 并 显示 ， 要 么 干脆 使 用 保守 估 
算 值 。 特 定 条 件 下 ， 尺 管 估算 比较 主观 ， 但 确实 是 唯一 切实 可 行 的 办 

法 。 再 添加 一 个 getScaledBitmap(String，Activity) 静 态 Bitmap 
估算 函数 ， 如 代码 清单 16-14 所 示 。 


代码 清单 16-14 编写 合理 的 缩放 函数 (PictureUtils.kt) 


fun getScaledBitmap(path: String, activity: Activity): Bitmap { 
val size = Point() 
activity.windowManager.defaultDisplay.getSize(size) 


return getScaledBitmap(path, size.x, size.y) 


} 


fun getScaledBitmap(path: String, destWidth: Int, destHeight: Int): Bitmap 


该 函数 先 确认 屏幕 的 尺寸 ， 然 后 按 此 缩放 图 像 。 这 样 ， 就 能 保证 载 入 的 
ImageView 永 远 不 会 过 大 。 无 论 如 何 ， 这 是 一 个 比较 保守 的 估算 ， 但 能 
解决 问题 。 


接 下 来 ， 为 了 把 Bitmap 载 入 ImageView， 在 CrimeFragment.kt 中 ， 添 加 
刷新 photoView 的 函数 ， 如 代码 清单 16-15 所 示 。 


代码 清单 16-15 ”更 新 photoView (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private fun updateUI() { 


} 


private fun updatePhotoView() ( 
if (photoFile.exists()) ( 
val bitmap = getScaledBitmap(photoFile.path, requireActivity()) 
photoView.setImageBitmap(bitmap) 
) else { 
photoView.setImageDrawable(null) 
j 
} 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: 


ve 


然后 ， 分 别 在 updateUI() 和 onActivityResult(...) 函 数 中 调 
用 updatePhotoview() 函 数 ， 如 代码 清单 16-16 所 示 。 


代码 清单 16-16 a HupdatePhotoView( ) 函数 
(CrimeFragment.kt ) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


private fun updateUI() { 


if (crime.suspect.isNotEmpty()) { 
suspectButton.text = crime.suspect 


} 
updatePhotoView() 


} 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: 
when { 


resultCode != Activity.RESULT_OK -> return 
requestCode == REQUEST CONTACT && data != null -> { 


} 


requestCode == REQUEST PHOTO -> ( 
updatePhotoView( ) 


如 代码 清单 16-17 所 示 ， 既 然 相 机 已 保存 了 文件 ， 那 就 再 次 调用 权限 ， 
关闭 文件 访问 。 这 里 ， 在 收 到 有 效 结果 时 ， 

在 onActivityResult(...) 里 执行 上 述 代码 。 同 时 ， 为 处 理 可 能 的 无 
效 返回 ， 也 别 忘 了 在 onDetach() 里 加 上 同样 的 处 理 逻 辑 。 


代码 清单 16-17 撤销 URI 权 限 (CrimeFragment.kt) 


class CrimeFragment : Fragment(), DatePickerFragment.Callbacks { 


override fun onStop() { 


} 


override fun onDetach() ( 
super .onDetach() 
requireActivity().revokeUriPermission(photoUri, 
Intent.FLAG GRANT WRITE URI PERMISSION) 
} 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: 
when { 


requestCode == REQUEST_PHOTO -> { 


requireActivity().revokeUriPermission(photoUri, 


Intent.FLAG GRANT WRITE URI PERMISSION) 
updatePhotoView() 


BiOSÍICriminalIntent Hj, HFA crime HANA, E HH RR PEL 


张 照 。 如 果 没 有 什么 问题 ， 你 应 该 可 以 看 到 已 拍照 片 的 缩 略图 了 ， 如 图 
16-3 上 所 示 。 
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图 16-3 ” 缩 略 图 出 现 了 


16.5 ”功能 声明 


应 用 的 担 照 功 能 用 起 来 不 错 ， 但 还 有 一 件 事情 要 做 ; 告诉 潜在 用 户 应 用 
ATH SARE 


假如 应 用 要 用 到 诸如 相机 、NFC， 或 者 任何 其 他 的 随 设 备 走 的 功能 时 ， 
都 应 该 让 Android 系 统 知 道 。 这 样 ， 假 如 设备 缺少 这 样 的 功能 ， 类 似 
Google Play 商店 的 安 闭 程 序 就 会 拒绝 安装 应 用 。 


为 了 声明 应 用 要 使 用 相机 ， 在 AndroidManifest.xml 中 加 入 <uses- 
feature> 标 签 ， 如 代码 清单 16-18 所 示 。 


代码 清单 16-18 ”添加 xuses-feature> 标 签 
(manifest/AndroidManifest.xml ) 


«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package-"com.bignerdranch.android.criminalintent" > 


«uses-feature android:name="android.hardware. camera” 
android: required="false"/> 


</manifest> 


注意 ， 我 们 在 代码 中 使 用 了 android:required 必 性。 默认 情况 下 ， 声 
明 要 使 用 某 个 设备 功能 后 ， 应 用 就 无 法 支持 那些 无 此 功能 的 设备 了 ， 但 
这 不 适用 于 CriminalIntent 应 用 。 这 是 因为 ，resolveActivity(...) 孔 
数 可 以 判断 设备 是 否 支 持 拍照 。 如 果 不 支 持 ， 束 直接 禁用 拍照 按钮 。 


无 论 如 何 ， 这 里 设置 android:required 属 性 为 false，Android 系 统 因 
此 就 知道 ， 尽 管 不 带 相 机 的 设备 会 寻 致 应 用 功能 缺失 ， 但 应 用 仍然 可 以 
正常 安装 和 使 用 。 

16.6 ”挑战 练习 : 优化 照片 显示 

现在 虽然 能 够 看 到 拍摄 的 照片 ， 但 没 法 看 到 照片 细节。 


请 创建 能 显示 放大 版 照片 的 DialogFragment。 只 要 点 击 缩 略图 ， 就 会 
弹出 这 个 DialogFragment， 让 用 户 查 看 放大 版 的 照片 。 


16.7 PARAS: 优化 缩 略 图 加 载 


本 章 ， 我 们 只 能 大 致 估算 缩 略图 的 目标 太 寸 。 虽 次 这 种 做 法 可 行 且 实施 
迅速 ， 但 还 不 够 理想 。 


Android 有 个 现成 的 名 为 ViewTree0bserver 的 API 工 具 可 用 。 你 可 以 从 
Activity 层 级 结构 中 获取 任何 视图 的 ViewTree0bserver 对 象 : 


val observer = imageView.viewTreeObserver 


你 可 以 为 ViewTree0bserver 对 象 设 置 包括 OnGlobalLayoutListener 
在 内 的 各 种 监听 器 。 使 用 OnGlobalLayoutListener 监 听 器 ， 可 以 监听 
任何 布局 的 传递 ， 控 制 事 件 的 发 生 。 


修改 代码 ， 使 用 有 效 的 photoview 尺 寸 ， 等 到 有 布局 切换 时 再 调 
用 updatePhotovView() 函数 。 


第 17 革 应 用 本 地 化 


我 们 预计 CriminalIntent 应 用 会 走红 ， 因 此 决定 让 更 多 的 用 户 用 上 它 。 先 
期 实施 的 将 是 应 用 的 中 文本 地 化 工作 。 

本 地 化 是 一 个 基于 设备 语言 设置 ， 为 应 用 提供 合适 资源 的 过 程 。 本 章 会 
为 CriminalIntent 应 用 提供 中 文 版 res/values/strings.xml。 设 备 语言 如 果 设 
置 为 中 文 ，Android 束 会 目 动 找 到 并 使 用 相应 的 中 文 资源 ， 如 图 17-1 所 
示 。 
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17.1 资源 本 地 化 


语言 设置 是 设备 配置 的 一 部 分 〈 详 见 3.5 市 ) 。 和 处 理 屏 医 方 辐 、 屏 大 

尺寸 以 及 其 他 配置 因 系 改变 一 样 ，Android 也 提供 了 用 于 不 同 语言 的 配 

置 修饰 符 。 本 地 化 处 理 因而 变 得 简单 : 创建 市 目标 语言 配置 修饰 符 的 资 
源 子 目录 ， 并 放 入 备 选 资源 。 其 余 工作 可 以 交 给 Android 资 源 系 统 目 动 

处 理 了 。 


在 项 目 工具 窗口 中 ， 右 键 单 击 res/values 目 录 ， 选 择 New > Values 
resource file 菜 单项 。 文 件 名 输入 strings.xml，Source set 选 中 main， 
Directory name 设 置 为 values。 


然后 ， 在 Available qualifiers 列 表 窗 口 ， 选 中 Locale， 使 用 >> 按 钮 把 它 移 
入 Chosen qualifiers 窗 口 ， 在 Language 列 表 窗 口中 选中 zh: Chinese, Jt 
时 ， 右 边 的 Specific Region Only 窗 口 会 自动 选中 Any Region， 这 就 是 我 
们 想 要 的 ， 无 须 更 改 。 


现在 ， 新 建 资 源 文件 窗口 应 该 类 似 于 图 17-2。 


File name: strings.xml 
Source set: main 
Directory name: — values-zh 


Available qualifiers: 


@ Country Code Ozh 
© Network Code 
T Layout Direction 
& Smallest Screen 
© Screen Width 

[] Screen Height 
b Size 

Ratio 

ij Orientation 

IE Ul Mode 

@ Night Mode 

[$ Density 
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图 17-2 ”新 建 资源 文件 窗口 


Chosen qualifiers: 


Language: 

um UZ: Uzbek 

WB ve: Venda 

El vi: Vietnamese 
vo: Volapük 
Tiwa: Walloon 
[4 wo: Wolof 

I xh: Xhosa 

I lyo: Yoruba 


WW zh: Chinese 
iS zu: Zulu 


Tip: Type in list to filter 


Specific Region Only: 
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lll CN: China 
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Cancel (ig 


JES, Android Studio 会 自动 设置 Directory name Avalues-zh. if zie 
修饰 符 来 自 ISO 639-1 标 准 代码 ， 每 个 修饰 符 都 由 两 个 字符 组 成 。 中 文 的 


修饰 符 为 -zh。 


点 击 OK 按 钮 完成 。 融 (zh) 后缀 的 新 strings.xml 文 件 会 在 res/values 下 列 
出 。 现 在 观察 一 下 ， 在 项 目 工 具 窗 口 ， 新 的 strings 资 源 文件 都 是 按 组 归 


类 的 ， 如 图 17-3 所 示 。 
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图 17-3 ”新 的 strings.xml 文 件 


然而 ， 如 果 查 看 目录 结构 ， 你 会 看 到 项 目 现 在 有 了 男 一 个 values 目 录 : 
res/values-zh。 新 生成 的 strings.xml 就 放 在 这 个 目录 里 ， 如 图 17-4 所 示 。 
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图 17-4 在 Project 视 图 中 查看 新 的 strings.xml 文 件 


现在 ， 开 始 真 正 的 中 文 定制 。 添 加 中 文字 符 串 资源 给 res/values- 


zh/strings.xml 文 件 ， 如 代码 清单 17-1 所 示 。 


代码 清单 17-1 


添加 中 文 备 选 字 符 串 资源 Ces/values- 


zh/strings.xml ) 

<resources> 
«string name="app_name">CriminalIntent</string> 
«string name-"crime title _hint">crime 简 短 描述 </string> 
«string name-"crime title 1abel" > 标题 </string> 
«string name-"crime details label"> 明 细 </string> 
«string name="crime_ solved label1"> 是 否 解决 </string> 
«string name="new_crime"> 新 增 crime 记 录 </string> 
«string name="crime_suspect_text" > 嫌疑 人 联系 方式 </string> 
«string name="crime_report_text" > 抗议 或 投诉 </string> 


<string 


name="crime_report">%1$¢s!crimeK‘EF %2¢s. %3$s, y %4¢s</string 


«string name="crime_report_solved" > 问题 已 解决 </string> 
«string name="crime_report_unsolved" > 问题 未 解决 /string> 
«string name="crime_report_no_suspect"> 没 找到 嫌疑 人 </stringy> 
«string name="crime_report_suspect" > 嫌疑 人 是 %s</string> 


«string name="crime_report_subject">crime 处 理 情况 报告 </string> 
«string name="send_report"> 投 诉 方式 </string> 
</resources> 


这 样 便 完成 了 为 应 用 提供 本 地 化 资源 的 任务 。 要 验证 成 果 ， 请 打开 
Settings， 找 到 语言 设置 选项 (Android 版 本 繁多 ， 但 语言 设置 选项 一 般 
被 标 为 Language and input. Language and Keyboard 或 其 他 类 似 名 称 ) ， 
将 设备 语言 改 为 简体 中 文 。 


运行 CriminalIntent 应 用 。 亲 切 叉 熟悉 的 中 文 界面 出 现 了 。 
17.1.1 默认 资源 


英文 语言 的 配置 修饰 符 为 -en。 处 理 完 中 文本 地 化 ， 你 自然 想到 也 把 原 

来 的 values 目 录 重 命名 为 values-en。 这 可 不 是 个 好 主意 。 现 在 假设 你 已 
经 这 么 做 了 : 应 用 现在 有 一 个 英文 版 values-en/strings.xml 和 一 个 中 文 版 
values-zh/strings.xml. 


运行 应 用 ， 一 切 都 很 正常 ， 语 言 改 为 中 文 ， 也 没 问 题 。 但 是 ， 如 果 有 个 
用 户 把 设备 语言 改 为 意大利 语 ， 会 出 现 什么 情况 呢 ? 问题 来 了 ， 后 果 很 
严重 ! 如 果 应 用 还 能 运行 ，Android 将 无 法 找到 匹配 当前 语言 设置 的 资 
源 。 这 时 ，Resources.NotFoundException 异 常 改 生 ， 应 用 会 骨 江 。 


Android Studio 会 采取 行动 让 你 免 遭 此 难 。 在 打包 应 用 资源 时 ，Android 
资源 打包 工具 CAAPT) 会 做 许多 检查 。 如 果 AAPT 发 现 你 正在 使 用 的 
资源 不 在 默认 资源 文件 里 ， 它 会 在 编译 时 报错 : 


Android resource linking failed 


warn: removing resource 
com.bignerdranch.android.criminalintent:string/crime title label 
without required default value. 


AAPT: error: resource string/crime title label 
(aka com.bignerdranch.android.criminalintent:string/crime title label) 
not found. 


error: failed linking file resources. 


这 一 事件 告诉 我 们 : 应 为 所 有 资源 提供 默认 资源 。 没 有 配置 修饰 符 的 资 
源 就 是 Android 的 默认 资源 。 如 果 无 法 找到 匹配 当前 配置 的 资源 ， 
Android 束 会 使 用 默认 资源 。 默 认 资 源 至 少 能 保证 应 用 正常 运行 。 


例外 的 屏幕 显示 密度 


Android 默 认 资 源 使 用 规则 并 不 适用 于 屏幕 显示 密度 。 项 目的 drawable 目 
录 通 常 按 屏幕 显示 密度 要 求 ， 市 有 -mdpi、-xxhdpi 这 样 的 修饰 人 符 。 不 
过 ，Android 决 定 使 用 哪 一 类 drawable 资 源 并 不 是 简单 地 匹配 设备 的 屏幕 
显示 密度 ， 也 不 是 在 没有 匹配 的 资源 时 直接 使 用 默认 资源 。 


最 终 的 选择 取决 于 对 屏幕 尺寸 和 显示 密度 的 综合 考虑 。Android 甚 至 可 
能 会 选择 低 于 或 高 于 当前 设备 屏幕 密度 的 drawable 资 源 ， 然 后 通过 缩放 
去 适 配 设备 。 无 论 如 何 ， 请 记 住 一 点 : 不 要 在 res/drawable/ 目 录 下 放置 
默认 的 drawable 资 源 。 


17.1.2 检查 资源 本 地 化 完成 情况 


是 否 已 为 某 种 语言 提供 全 部 本 地 化 资源 ? 应 用 文 持 的 语言 越 来 越 多 ， 想 
快速 确认 也 越 来 越 难 。Google 早 已 想到 这 点 ， 所 以 Android Studio 提 供 了 
资源 翻译 编辑 器 这 个 工具 。 这 个 便利 工具 能 集中 但 看 资源 翻译 完成 情 
况 。 开 始 之 前 ， 打 开 上 默认 的 strings.xml， 注 释 掉 crime_details_label 和 
crime_title_label 定 义 ， 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 注释 掉 一 些 资 源 定 义 (res/values/strings.xml) 


<resources> 
«string name-"app name"»Criminallntent«/string» 
«string name-"crime title hint"»Enter a title for the crime.</string> 
<!--<string name-"crime title label"»Title«/string»--» 
<!--<string name-"crime details label"»Details«/string»--» 
«string name-"crime solved label"»Solved«/string» 


</resources> 


要 启动 资源 翻译 编辑 器 ， 在 项 目 工 具 窗 口 右键 单 击 某 个 语言 版 本 的 
strings.Xxml， 选 择 Open Translations Editor 菜 单项 即 可 。 如 图 17-5 所 示 ， 


资源 翻译 编辑 占 随 即 显示 了 对 应 语言 的 全 部 资源 定 
X. crime details label 和 crime title label 的 定义 已 注释 ， 所 


以 它们 被 标 红 了 。 


+ = @ ShwAlKes v Show AllLocales v. § ? 


Key Resource Folder — Untranslatable 
app. name app/srcimainires — | | 
crime title hint app/src/mainres — |. 
crime title label app/srcimainires | 
crime details label app/srcimainjres | 
crime solved label app/srcimainires | | 
new. crime app/sro/man/res — [| 
crime suspecttext — app/rmanfes — |. 
crime report applsrc/main/res — | | 


crime report solved ^ app/src/main|res 


crime report unsolved — app/src/main/res 
crime report no. suspect app/src/main/res 
Crime report suspect — app/src/main/res 


| 
| 
| 
| 
| 
| 
Crime report text app/src/mai 
| 
| 
| 
| 
| 
crime report subject —— app/src/main/res 
| 


| 
| 
| 
| 
| 
| 
n/res 
| 
| 
| 
| 
| 
| 
| 


send report app/src/main/res 


图 17-5 ”检查 应 用 本 地 化 完成 情况 
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J 


Default Value Chinese (zh) 
Criminallntent Criminallntent 
Enter a title for the crime. Crime 简短 描述 
Dri! 
明细 
Solved 是 否 解决 
New Crime 新 增 crime 记 录 


Choose Suspect BARAT 

Send Crime Report 抗议 或 投诉 

"4! $s![..] "o $slcrime REF 0285. 438s, 
The case is solved 问题 解决 

The case is not solved 问题 未 解决 

there is no suspect. aaa RA 

the suspect is %s. WRAT NS 

Criminalintent Crime Report crime 处 理 情况 报告 

Send crime report via = RRA 


可 以 看 到 ， 得 到 要 添加 到 项 目 中 的 未 处 理 资 源 的 清单 很 容易 。 借 此 ， 找 
到 区 域 配置 里 所 有 遗漏 未 处 理 的 资源 ， 在 对 应 字符 串 文件 里 加 上 它们 。 


虽然 可 以 直接 在 资源 翻译 编辑 器 中 添加 字符 串 资源 ， 但 这 里 只 要 取消 对 
crime details label 和 crime title _ label 的 注释 就 可 以 了 。 继 续 
学 习 之 前 ， 记 得 取消 资源 注释 。 


17.1.3 ”区 域 修饰 符 


修饰 资源 目录 也 可 以 使 用 语言 加 区 域 修饰 符 ， 这 样 可 以 让 资源 使 用 更 有 
针对 性 。 例 如 ， 西 班 牙 语 可 以 使 用 -es-rES 修 饰 符 ， 其 中 ，r 代 表 区 域 ， 

ES 是 西班牙 语 的 ISO 3166-1-alpha-2 标 准 码 。 配 置 修饰 符 不 区 分 大 小 写 。 
但 最 好 遵守 Android 命 名 约定 : 语言 代码 小 写 ， 区 域 代 码 大 写 ， 但 前 面 
加 个 小 写 的 r。 


注意 ， 语 言 区 域 修饰 符 ， 比 如 -es-rES， 看 上 去 像 两 个 不 同 的 修饰 符 的 合 
体 ， 实 际 并 非 如 此 。 这 是 因为 ， 区 域 本 身 不 能 单独 用 作 修 饰 符 。 


如 果 一 个 资源 修饰 符 同时 包含 locale 和 区 域 ， 那 么 它 有 两 次 机 会 匹配 用 
户 的 locale。 首 先 ， 如 果 语 言 和 区 域 修饰 同时 匹配 用 户 的 locale， 那 这 束 
是 一 次 精准 匹配 。 如 果 是 非 精 准 匹 配 ， 系 统 会 去 除 区 域 修饰 ， 然 后 仅 以 
语言 去 做 精准 匹配 。 


找 不 到 精准 匹配 资源 ， 系 统 会 选 什么 样 的 资源 呢 ? 不同 版 本 系统 的 设备 
有 不 同 的 处 理 方式 。 图 17-6 展 示 了 Android 不 同系 统 版 本 的 区 域 资 源 匹 配 
策略 Nougat 之 前 及 之 后 的 系统 版 本 )。 
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117-6 ”区 域 资源 匹配 策略 (Nougat 之 前 及 之 后 的 系统 版 本 ) 


在 运行 Nougat 之 前 的 系统 版 本 的 设备 上 ， 如 果 找 不 到 匹配 的 资源 ， 应 用 
就 会 使 用 无 任何 修饰 符 的 默认 资源 。 


Nougat 及 其 之 后 的 系统 版 本 已 优化 locale 支 持 ， 支 持 更 多 locale 以 及 支持 
同一 设备 选择 多 个 locale。 因 此 ， 为 了 让 应 用 显示 更 准确 的 语言 ， 系 统 
使 用 了 更 智能 化 的 资源 匹配 策略 。 如 采 找 不 到 精准 匹配 ， 也 找 不 到 仅 针 
对 语言 的 匹配 ， 系 统 就 会 去 匹配 有 同样 语言 而 区 域 不 同 的 资源 。 


REMIT. (kK ei a RENE IA, DOSOXEOJS i 
17-7 AN. DAMES T VUE Pic AS A SS UU ap AAS EY SUR Cvalues-es-rES 
Alvalues-estMX) ， 以 及 默认 的 strings.xml 资 源 。 


WhatsForDinner 应 用 的 资源 ， 
Strines xml 文件 


values (默认 ) ， 


«string nane="app_name">Menu</string> 
<string nanez main course"»Main course«/string» 
<string nane="prawns">Shrinps/string> 


valueseeserES (aM YH, PEYRA): 


«string nane="app_name" sMenu</string> 
<string nane="nain_course' Plato principal</string> 
«string nane="prawns'>Gambas</string> 


values-es-rlX (HEFE, Resp A). 


«string nanez"app nane"sMen(«/string» 
«string nanez" nain course"»Plato fuertes/string> 
«string nanez"prauns"»Camarones«/string» 


设 各 |ocale 为 -t5CL 
RFR, SAN) 
" 12:50 
Menu 
| MAN COURSE Shrimp Nougat al 


MAAR 


9, 0700 
Menu 


一 一 PLATO FUERTE Camarones 


Nougat 


图 17-7 区域 匹 配 实例 (Nougat 之 前 及 之 后 的 系统 版 本 ) 


如 果 是 Nougat 之 前 的 系统 版 本 ， 应 用 会 使 用 默认 资源 。 如 果 是 Nougat 及 
其 之 后 的 系统 版 本 ， 应 用 会 使 用 values-es-rMX/strings.xml 资 源 。 怎 么 
样 ， 智 能 多 了 吧 ! 


以 上 例子 有 策划 之 嫌 。 但 无 论 如 何 ， 可 从 中 得 出 一 个 重要 结论 : 资源 应 
尽 可 能 通用 ， 最 好 是 使 用 仅 限 语言 的 修饰 目录 ， 尽 量 少 用 区 域 修 饰 。 就 
上 例 来 说 ， 与 其 维护 三 类 不 同 区 域 西 班 牙 语 的 资源 ， 不 如 只 提供 values- 
es 版 资源 。 

这 样 ， 不 仪 方便 开发 维护 ， 也 方便 适 配 不 同 版 本 的 系统 (Nougat 之 前 及 
之 后 的 系统 版 本 ) 。 另 外 ， 上 述 结 论 也 适用 于 values 目 录 里 的 其 他 备 选 
资源 。 总 之 ， 我 们 应 该 使 用 通用 目录 提供 共享 资源 ， 那 些 需 要 定制 化 的 
资源 就 放 在 带 有 更 具体 修饰 符 的 目录 里 吧 。 

17.2 ”配置 修饰 符 

目前 为 止 ， 我 们 已 见 过 好 几 个 配置 修饰 符 ， 它 们 都 用 于 提供 可 选 资源 ， 


比如 语言 Cvalues-zh) . 6487718) Clayout-land) 和 屏幕 显示 密度 
(drawable-mdpi) 。 


表 17-1 列 出 了 一 些 设备 配置 特征 。 针 对 它们 ，Android 会 使 用 配置 修饰 符 
匹配 资源 。 


表 17-1 可 融 配 置 修饰 符 的 设备 配置 特征 


移动 国家 码 ， 通 常 附 有 移动 网 络 码 


1 

2 ii 
E T 
E] 
| 


高 动态 范围 


非 文本 导航 方法 


不 是 所 有 配置 修饰 符 都 能 在 早期 版 本 Android 系 统 获得 文 持 。 系 统 知道 
这 一 点 ， 所 以 会 给 Android 1.0 之 后 出 现 的 修饰 符 加 上 平台 版 本 修饰 符 。 
例如 ， 圆 形 屏幕 修饰 符 目 API 23 级 别 引 入 ， 用 到 它 时 ， 系 统 会 自动 加 上 
V23。 因 此 ， 如 果 为 新 设备 引入 资源 修饰 符 ， 根 本 不 用 担心 在 旧 系 统 中 


会 遇 到 问题 。 
17.2.1 可 用 资源 优先 级 排 定 


考虑 到 有 那么 多 匹配 资源 的 配置 修饰 符 ， 有 时 ， 会 出 现 设 备 配置 与 好 几 
个 可 选 资源 都 匹配 的 情况 。 遇 到 这 种 状况 ，Android 会 基于 表 17-1 的 顺序 
确定 修饰 符 的 使 用 优先 级 。 


为 实际 了 解 这 种 优先 级 排 定 ， 我 们 为 CriminalIntent 应 用 再 添加 一 种 可 选 
资源 :更 详细 的 crime_title_hint 字 符 串 资源 (针对 屏幕 宽度 至 少 
600dp 的 设备 ) 。crime title_hint 资 源 显 示 在 crime 的 可 编辑 标题 框 
里 (用 户 输入 标题 前 ) 。 应 用 运行 在 平板 或 者 横 屏 的 设备 上 时 ( 屏 宽 至 
^beo0dp) ， 标 题 框 才 会 显示 更 详细 的 内 容 ， 提 示 用 户 输入 crime 标 题 。 


参考 17.1 节 创建 资源 文件 的 步 又， 新 建 一 个 名 为 strings 的 字符 串 资源 文 
件 。 在 Available qualifiers 列 表 窗 口 ， 选 中 Screen Width， 使 用 >> 按 钮 把 
它 移入 Chosen qualifiers 窗 口 。 在 Screen width 栏 位 处 输入 600。 可 以 看 
到 ，Directory name 会 自动 设置 为 values-w600dp 。-w600dp 会 匹配 屏幕 宽 
度 大 于 600dp 的 任何 设备 。 当 然 ， 如 果 横 屏 设备 的 屏幕 符合 条 件 也 可 以 
匹配 。 设 置 完 成 后 的 界面 应 该 和 图 17-8 一 样 。 


File name: strings 
Source set: — main 


Directory name;  values-w600dp 


Avallable qualiflers: 


@ Country Code 

@ Network Code 

Q) Locale 

E Layout Direction 

E: Smallest Screen Width 


Îl Screen Height E 


F Size 
[Ratio 

fs Orientation 
T UI Mode 

€) Night Mode 
Th Density 

P Touch Sereen 
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New Resource File 


Chosen qualifiers: Sereen with: 


bal wO00ap 600 


Cancel 


图 17-8 AKERS FT ODE 


现在 ， 打 开 res/values-w600dp/strings.xml 文 件 ， 参 照 代码 清单 17-3， 


为 crime_title_hint 添 加 更 详细 的 文字 描述 。 


E ANNAN 


代码 清单 17-3” 人 针对 宽屏 的 字符 串 资源 Cres/values- 
w600dp/strings.xml ) 


<resources> 


<string name="crime_title_hint"> 
Enter a meaningful, memorable title for the crime. 


</string> 


</resources> 


在 宽屏 上 ， 我 们 只 希望 看 到 crime_title_hint 字 符 串 有 不 同 的 描述 ， 
所 以 添加 这 一 个 就 可 以 了 。 基 于 某 些 配置 修饰 ， 必 须 用 到 不 同 资源 时 ， 
才 需 要 提供 特定 字符 串 备 选 资 源 ( 也 包括 其 他 values 资 源 ) 。 因 此 ， 字 
符 串 资源 相同 时 ， 无 须 再 复制 一 份 。 重 复 的 字符 串 资 源 越 多 ， 将 来 维护 


现在 总 共有 三 个 版 本 的 crime_title_hint 资 源 : res/values/strings.xml 
文件 中 的 默认 版 本 、res/values-zh/strings.xml 文 件 中 的 中 文 备 选 版 本 ， 以 
及 res/values-w600dp/strings.xml 文 件 中 的 宽屏 备 选 版 本 。 


在 设备 语言 设置 为 简体 中 文 的 前 提 下 ， 运 行 CriminalIntent 必 用 ， 然 后 旋 
转 设备 至 横 屏 模式 。 因 为 中 文 备 选 版 本 的 资源 优先 级 最 高 ， 所 以 我 们 看 
到 的 是 来 自 values-zh/strings.xml 文 件 的 字符 串 资 源 ， 如 图 17-9 所 示 。 
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图 17-9 Android 排 定语 言 优先 级 高 于 屏幕 方 回 


也 可 以 将 设备 语言 重新 设置 为 英语 ， 然 后 再 次 运行 应 用 ， 确 认 宽屏 模式 
的 字符 串 资源 使 用 符合 预期 。 


17.2.2 多重 配 置 修饰 符 


可 以 在 同一 资源 目录 上 使 用 多 个 配置 修饰 符 。 这 需要 各 配置 修饰 符 按照 
优先 级 别 顺序 排列 。 因 此 ，values-zh-w600dp 是 一 个 有 效 的 资源 目录 

名 ，values-w600dp-zh 目 录 名 则 无 效 。〔 在 新 建 资源 文件 对 话 框 中 ， 工 
具 会 自动 配置 正确 的 目录 名 。) 


为 CriminalIntent 应 用 准备 宽屏 模式 的 中 文字 符 串 资源 。 创 建 的 资源 目录 
名 应 为 values-zh-w600dp 。 参 照 代 人 码 清单 17-4， 打 开 values-zh- 
w600dp/strings.xml 文 件 ， 为 crime_title_hint 添 加 中 文字 符 串 资源 。 


代码 清单 17-4 ”创建 宽屏 中 文 版 字符 串 资源 (res/values-zh- 
w600dp/strings.xml ) 


<resources> 
<string name="crime_title_hint"> 


请 输入 简短 、 好 记 的 crime 描 述 
</string> 
</resources> 


在 设备 语言 已 设置 为 简体 中 文 的 前 提 下 ， 运 行 CriminalIntent 心 用， 确认 
能 看 到 新 的 备 选 资 源 ， 如 图 17-10 所 示 。 


OF 


€ Criminalintent 


标题 


请 输入 向 短 、 好 记 的 crime 拍 述 


明细 
THU MAR 16 10:31:11 GMT+08:00 2017 
[] 是 否 解 决 
图 17-10 ”宽屏 模式 下 的 中 文字 符 串 资源 
17.2.3 “寻找 最 匹配 的 资源 
本 节 ， 我 们 来 看 看 Android 是 如 何 确定 crime_title_hint 资 源 版 本 的 。 
首先 ， 当 前 设备 有 以 下 四 个 版 本 的 字符 串 备 选 资源 用 于 


crime title hint: 


e values/strings.xml 

e values-zh/strings.xml 

e values-w600dp/strings.xml 

e values-zh-w600dp/strings.xml 


其 次 ， 在 设备 配置 方面 ， 有 人 台 Pixel 2， 语 言 设 为 简体 中 文 ， 处 于 横 屏 状 
态 ， 屏 宽 600dp 以 上 《可 用 宽度 731dp， 可 用 高 度 411dp) 。 


01. 


02. 


排除 不 兼容 的 目录 


要 找到 最 匹配 的 资源 ，Android 首 先 排除 不 兼容 当前 设备 配置 的 资 
源 目录 。 


结合 备 选 资源 和 设备 配置 来 看 ， 四 个 版 本 的 备 选 资源 均 兼 容 设备 的 
当前 配置 。〈 如 果 将 设备 竖 起 来 ， 设 备 配置 会 改变 。 此 时 ，values- 
w600dp/ 与 values-zh-w600dp/ 资 源 目录 不 兼容 当前 配置 ， 因 此 排 

ER. ) 


按 优先 级 表 排 除 不 兼容 的 目录 


第 选 掉 不 兼容 的 资源 目录 后 ， 自 优先 级 最 高 的 MCC (移动 国家 
码 ) 开始 ，Android 逐 项 查看 并 按 优 先 级 表 继 续 筷 查 不 兼容 目录 
( 表 17-1) 。 如 果 有 任何 以 MCC 为 修饰 符 的 资源 目录 ， 那 么 所 有 不 
带 MCC 修 饰 符 的 都 会 被 排除 。 如 果 仍 有 多 个 目录 匹配 ，Android 就 
S epee 如 此 反复 ， 直 至 找到 唯一 满足 兼容 性 的 目 


本 例 中 没有 目录 包含 MCC 修 饰 符 ， 因 此 无 法 筷 选 掉 任 何 目录 。 接 
者 ，Android 碍 看 到 次 高 优先 级 的 设备 语言 修饰 符 。values-zh 和 
values-zh-w600dp 目 录 包 含 语 言 修 饰 符 。 因 此 ， 不 包含 语言 修饰 符 
的 values 和 values-w600dp 可 排除 。 


〈 然 而， 本章 前 面 说 过 ， 没 有 任何 修饰 符 的 values 是 默认 资源 ， 是 
最 后 的 保障 。 现 在 ， 尽 管 因 缺少 语言 修饰 它 被 排除 挤 了 ， 但 如 果 其 
他 values 目 录 在 某 个 低 优先 级 修饰 上 没有 资源 可 匹配 ，values 依 然 会 
挺身 而 出 成 为 最 佳 匹 配 资源 。) 


由 于 仍 有 多 个 目录 匹配 ， 因 此 继续 看 优先 级 表 ， 接 下 来 是 屏幕 宽 
上 度 。 此 时 ，Android 会 找到 一 个 带 屏 宽 修 饰 符 的 目录 以 及 两 个 不 带 
屏 宽 修饰 符 的 目录 ， 因 此 ，values 和 values-zh 目 录 也 被 排除 。 就 这 
样 ，values-zh-w600dp 成 了 唯一 满足 兼容 需求 的 目录 。 


而 ，Android 最 终 确定 使 用 values-zh-w600dp 目 录 下 的 资源 。 


17.3 测试 备 选 资源 


开发 应 用 时 ， 为 了 奏 看 布局 以 及 其 他 资源 的 使 用 效果 ， 一 定 要 针对 不 同 
设备 配置 做 好 测试 。 在 虚拟 设备 或 实体 设备 上 测试 都 行 ， 还 可 以 使 用 图 
形 布 局 工具 测试 。 


图 形 布局 工具 有 很 多 选项 ， 用 以 预览 布局 在 不 同 配置 下 的 显示 效果 。 这 
些 选项 有 屏幕 尺寸 、 设 备 类 型 、API 级 别 以 及 设备 语言 等 。 


要 查看 这 些 选项 ， 可 在 图 形 布局 工具 中 打开 
res/layout/fragment_crime.xml 文 件 ， 试 用 如 图 17-11 所 示 的 工具 栏 上 的 一 
些 选 项 设置 。 


@~ S~ | Pixely æ 287 (€ AppTheme- © Default (en-us) v 


图 17-11 使 用 图 形 布局 工具 预览 资源 


如 果 想 确认 项 目 是 否 包 括 所 有 必需 的 默认 资源 ， 可 设置 设备 使 用 未 提供 
本 地 化 资源 的 语言 。 运 行 应 用 ， 查 看 所 有 视图 界面 并 旋转 设备 。 


在 继续 下 一 章 之 前 ， 你 可 能 需要 将 设备 的 语言 改 回 英语 。 
RE l Criminallntet YHL FAL. AS EVERIP B. MHHE 
KERM. BAR, EMH SCENE BÍRIB EE, EEN EAT 
的 额外 资源 文件 而 已 ! 

17.4 深入 学 习 : 确定 设备 屏幕 尺寸 


Android 提 供 了 三 个 修饰 符 ， 用 于 测试 设备 尺寸 。 表 17-2 列 出 了 这 些 新 修 
饰 符 。 


表 17-2 不 同 的 屏幕 尺寸 修饰 符 


6 符 格 式 


wXXXdp 可 用 宽度 : 大 于 或 等 于 XXXdp 


bes | AFREK 


最 小 宽度 : 宽 或 高 〈 看 哪个 更 小 ) 大 于 或 等 于 XXXdp 


假设 要 指定 一 个 布局 仅 在 屏幕 至 少 300dp 宽 时 使 用 。 据 此 ， 你 可 以 使 用 
一 个 可 用 的 宽度 修饰 符 ， 把 布局 文件 放 在 res/layoutr-w300dp 〈w 代 表 宽 
Be. HH, WRAS) 这 样 的 目录 中 。 


然而 ， 由 于 设备 旋转 ， 高 度 和 宽度 会 交换 过 来 。 为 检测 某 个 特殊 的 屏幕 
尺寸 ， 可 以 使 用 sw (最 小 宽度 ) 。 这 样 ， 就 可 以 指定 屏幕 的 最 小 尺寸 
了 。 由 于 设备 会 旋转 ， 这 个 最 小 尺寸 可 以 是 高 度 ， 也 可 以 是 宽度 。 如 果 
屏幕 尺寸 是 1024 x 800, AhAswht7e800; 如 果 屏 幕 尺 寸 是 800 x 1024, 
那么 sw 还 是 800。 


175 ”挑战 练习 : 日 期 显示 本 地 化 


你 可 能 注意 到 了 ， 不 管 设备 locale 怎 么 调整 ，CriminalIntent 应 用 的 日 期 
总 是 美国 格式 。 请 按照 设备 locale 设 置 ， 进 一 步 本 地 化 ， 让 日 期 以 中 文 
£F. H ^ H 显 不 。 这 个 练习 应 该 难 不 倒 你 。 


查阅 开发 者 文档 有 关 DateFormat 类 的 用 法 和 指导 。DateFormat 类 有 个 
日 期 格式 化 工具 ， 其 支持 按 locale 进 行 日 期 格式 化 。 使 用 该 类 内 置 的 配 
置 常 量 ， 还 可 以 进一步 定制 日 期 显示 格式 。 


第 18 音 Android 辅 助 功能 


本 章 ， 我 们 让 CriminalIntent 心 用 更 易 用 。 一 个 易 用 的 应 用 适合 所 有 人 
(包括 视力 、 行 动 、 听 力 有 障碍 的 人 ) 使 用 。 有 些 障 碍 是 永久 性 的 ， 有 
些 障碍 是 暂时 性 的 或 特定 场景 下 的 : 刚 经 过 眼科 检查 后 ， 瞳 孔 放 大 ， 有 眼 
睛 会 看 不 清楚 ; 做 饭 油 乎 乎 的 手 难 以 触 碰 屏幕 ;音乐 厅 里 的 音乐 声 盖 过 
了 手机 的 一 切 声 音 ， 等 等 。 总 之 ， 应 用 越 易 用 ， 用 户 就 越 开 心 。 

开发 适合 所 有 人 的 易 用 应 用 非常 困难 ， 但 不 能 因为 有 困难 束 退 缩 。 本 


章 ， 利 用 学 习 开 发 或 设计 易 用 应 用 的 突破 口 ， 我 们 先 迈 出 一 小 步 ， 让 视 
力 障 人 碍 用 户 也 能 方便 地 使 用 CriminalIntent 应 用 。 


本 章 所 做 的 工作 不 会 修改 用 户 界 面 。 我 们 会 用 一 个 名 为 TalkBack 的 辅助 
工具 ， 让 应 用 更 加 易 用 。 


18.1 TalkBack 


TalkBack 是 Google 开 发 的 Android 屏 幕 阅 读 器 。 用 户 可 以 操作 它 ， 读 出 屏 
幕 上 的 内 容 。 


TalkBack 实 际 是 一 个 辅助 服务 ， 这 个 特别 的 部 件 能 读 取 应 用 屏幕 上 的 信 
恩 〈 无 论 哪 种 应 用 都 可 以 ) JA BEAN GRO, EA DAFT ARF BU Ar B 
服务 。 但 TalkBack 已 经 非常 好 用 ， 其 应 用 相当 广泛 。 


要 使 用 TalkBack， 首 先 要 通过 Play Store 应 用 在 设备 上 安装 Android 
Accessibility Suite， 如 图 18-1 所 示 。 如 果 使 用 虚拟 设备 ， 那 要 确保 模拟 
器 镜像 里 安装 了 Play Store 应 用 。 


Android Accessibility Suite 
Google LLC 
© Everyone 


Includes Google TalkBack, Switch Access, and 
Select to Speak 


名 


READ MORE 


图 18-1 Android Accessibility Suite 


然后 ， 确 认 手 机 没有 静音 。 不 过 ， 建 议 先 找 副 耳机 戴 着 ， 因 为 一 旦 启用 
TalkBack， 手 机 就 会 唆 唆 不 体 地 说 个 没完 。 


要 启用 TalkBack， 请 打开 设置 ， 点 击 辅助 功能 。 在 Screen readers 下 ， 点 
击 TalkBack 打 开 它 。 然 后 ， 点 击 右 上 和 角 的 Use service 开 关 启 用 
TalkBack， 如 图 18-2 所 示 。 


9:00 *v UEM B 


€ TalkBack 
Settings 


When TalkBack is on, it provides spoken feedback 
so that you can use your device without looking at 
the screen. This can be helpful for people who are 
blind or have low vision. 


To navigate using TalkBack: 

* Swipe right or left to move between items 
* Double-tap to activate an item 

* Drag two fingers to scroll 


To turn off TalkBack: 
* Tap the switch. You'll see a green outline. 
Double-tap the switch. 


* On the confirmation message, tap OK. Then 
double-tap OK. 


图 18-2 TalkBack 设置 屏 


如 图 18-3 所 示 ，Android 会 弹出 一 个 对 话 框 ， 要 求 用 户 对 诸如 监测 用 户 行 
为 、 修 改 某 些 设置 这 样 的 操作 授权 。 点 击 OK 按 钮 同意 即 可 。 


b du E 


Use TalkBack? 
TalkBack needs to: 


* Observe your actions 
Receive notifications when you're 
interacting with an app. 


* Retrieve window content 
Inspect the content of a window you're 
interacting with. 


* Turn on Explore by Touch 
Tapped items will be spoken aloud and the 
screen can be explored using gestures. 


* Observe text you type 
Includes personal data such as credit card 
numbers and passwords. 


* Control display magnification 
Control the display's zoom level and 
positioning. 


* Fingerprint gestures 
Can capture gestures performed on the 
device's fingerprint sensor. 


CANCEL OK 


图 18-3 ”授权 使 用 TalkBack 


现在 ，TalkBack 己 处 于 启用 状态 (如 果 是 首次 使 用 ， 还 会 看 到 使 用 演示 
教程 ) 。 点 击 工 具 栏 同上 按钮 退出 。 


注意 ， 此 时 屏幕 上 是 不 是 有 了 变化 ? 一 个 方 框 出 现在 了 向 上 按钮 上 ， 如 
图 18-4 所 示 。 而 且 设 备 开 始 说 话 :“ 向 上 导航 按钮 ， 连 点 两 下 可 激活 


已 33 
o 


TalkBack 


向 上 导航 按钮 ， 
连 点 两 下 可 激活 它 。 


Use Service 


Settings 


Q When TalkBack is on, it provides spoken feedback 
so that you can use your device without looking at 
the screen. This can be helpful for people who are 
blind or have low vision. 


To navigate using TalkBack 

* Swipe right or left to move between items 
* Double-tap to activate an item 

* Drag two fingers to scroll 


To turn off TalkBack: 

* Tap the switch. You'll see a green outline. 
Double-tap the switch. 

* On the confirmation message, tap OK. Then 
double-tap OK 


18-4 ”TalkBack 己 启用 


(虽然 在 移动 设备 屏幕 上 操作 时 “点 击 ” 是 第 见 的 说 法 ， 但 TalkBack 会 使 
FANS LIE] eS DLE RESP IUS ) 


方 框 表示 当前 UI 元 素 获得 了 辅助 焦点 。 一 次 只 能 有 一 个 UI 元 素 得 到 辅助 
焦点 。UI 元 素 得 到 辅助 焦点 后 ，TalkBack 会 提供 该 UI 元 素 的 信息 。 


设备 月 用 TalkBack 后 ， 点 操作 会 给 予 UI 元 素 焦 点 。 在 屏幕 任何 位 置 连 点 
两 次 ， 会 激活 有 焦点 的 元 系 。 所 以 ， 当 疝 上 按钮 获得 焦点 后 ， 连 点 两 次 
就 回 到 上 一 屏 了 。 如 果 是 checkbox 获 得 焦点 ， 连 点 两 次 就 是 切换 勺 选 状 
So (EE, WAR Ce DE 了， 点 锁 屏 按钮 ， 然 后 连 点 两 次 屏幕 任何 地 
TRMD ) 


18.1.1 点击 浏 览 


只 要 启用 了 TalkBack， 点 击 浏览 (Explore by Touch) 功能 也 会 开启 。 这 
就 意味 着 ， 点 击 某 UI 元 素 ， 设 备 就 会 读 出 相关 人 信息。 当然 ， 被 点 击 的 


UI 元 素 要 有 可 读 信 息 才 行 。) 


让 同上 按钮 仍 处 于 聚焦 状态 ， 连 点 两 次 屏幕 任何 地 方 ， 设 备 会 返回 到 
Accessibility 屏 。TalkBack 就 会 读 出 屏幕 上 的 信息 ， 有 聚焦 焦点 在 哪 
里 :“ 向 上 导航 按钮 ， 连 点 两 下 可 激活 它 。” 


Android 框 架 里 的 部 件 ， 比 如 Toolbar、RecyclerView 和 Button， 默 认 
都 支持 TalkBack。 想 要 用 好 TalkBack 辅 助 功 能 ， 应 尽 可 能 多 用 框架 内 置 
部 件 。 当 然 ， 也 可 以 让 定制 部 件 文 持 TalkBack 辅 助 功能 ， 不 过 ， 这 个 话 
题 比 较 复 杂 ， 已 超出 本 书 讨论 范畴 。 


在 物理 设备 上 ， 需 要 两 根 手指 按 住 屏幕 上 下 滚动 才能 滚动 列表 。 在 模拟 
器 上 ， 按 住 键盘 上 的 Command (Ctrl) 键 ， 点 击 屏幕 上 两 个 稍 大 一 些 的 
半 透 明 圆 中 的 一 个 ， 同 上 或 同 下 拖 动 ， 如 图 18-5 所 示 。 


€ Accessibility Qa 


Volume key shortcut 
off 


Downloaded services 
Accessibility Scprrmex 
Off / Developer (neg: 
Screen readers 

Select to Speak 

Off / Hear selected @) 
TalkBack 

Off / Speak items on Screen 
Text-to-speech 


Display 


Font size 
Default 


Display size 


< o E] 


图 18-5 ”在 模拟 部 上 滚动 
列表 有 长 有 短 ， 滚 动 时 ， 设 备 会 发 出 声 啊 。 这 实际 是 对 滚动 的 一 种 声音 


反馈 。 


18.1.2 ”线性 浏览 


想象 一 下 ， 你 第 一 次 点 击 浏览 一 个 应 用 会 是 什么 情况 ? 很 可 能 你 不 知道 
应 该 点 击 哪个 按钮 。 你 明白 ， 要 想 知道 按 了 什么 按钮 ， 只 能 等 TalkBack 
读 出 聚焦 按钮 说 明 才 行 。 这 会 是 一 种 什么 体验 ? 结果 很 可 能 是 多 次 按 同 
一 个 按钮 ， 甚 至 完全 找 不 到 目标 。 


好 在 TalkBack 还 有 线性 浏览 功能 。 事 实 上 ， 使 用 TalkBack 最 常见 的 方式 
就 是 使 用 线性 浏览 : 向 右 滑 屏 ， 辅 助 焦点 移动 到 下 一 个 UI 元 素 ; 向 左 滑 
屏 ， 移 动 到 上 一 个 UI 元 素 。 这 样 ， 用 户 束 可 以 线性 浏览 应 用 ， 再 也 不 用 
碰 运 气 了 。 


下 面 一 起 来 体验 一 下 。 启 动 CriminalIntent 应 用 ， 进 入 crime 明 细 界 面 。 辅 
助 焦点 默认 是 工具 栏 上 的 新 建 crime 操 作 项 (如 果 不 是 这 样 ， 请 自己 让 

FUSE AE) 。 如 图 18-6 所 示 ， 设 备 开始 朗读 “添加 新 crime， 连 点 两 下 可 激 

5 Er 


9:00 


Criminallnten 
添加 新 crime， 


连 点 两 下 可 激活 它 。 


Scooter stolen while going to the restroom 
Tue Mar 12 20:42:33 EDT 2019 


Paper clip Ponzi scheme Q 
Tue Mar 12 20:45:19 EDT 2019 WO 


Instagram photos at beach on sick day 
Mon Apr 15 00:00:00 EDT 2019 


Fragment fraud 
Fri Dec 21 00:00:00 EST 2018 


Popcorn left unattended, microwave on 


fire 9o 


Mon Apr 01 00:00:00 EDT 2019 


图 18-6 “新建 crime 按 钮 已 聚焦 


对 于 菜单 项 和 按钮 这 样 的 框架 部 件 ，TalkBack 会 默认 读 出 部 件 上 显示 的 
文字 。 添 加 的 新 crime 按 钮 上 没有 文字 ，TalkBack 会 去 找 其 他 地 方 。 在 菜 
单项 XML 文件 中 ， 我 们 指定 过 标题 信息 Cile) ， 于 是 TalkBack 惑 找到 
该 信息 并 读 出 。 有 时 ，TalkBack 也 能 告诉 用 户 某 个 部 件 接受 什么 操作 ， 

或 这 是 什么 部 件 。 


现在 ， 回 左 滑 屏 。 如 图 18-7 所 示 ， 辅 助 焦点 随即 移动 到 应 用 工具 栏 标题 
上 。TalkBack 读 到 : “CriminalIntent”。 


9:00 vai 


zriminallnten: + 


Scooter stolen while going to the restroom 
Tue Mar 12 20:42:33 EDT 2019 


Paper clip Ponzi scheme Qo 
Tue Mar 12 20:45:19 EDT 2019 


Instagram photos at beach on sick day 
Mon Apr 15 00:00:00 EDT 2019 


Fragment fraud 
Fri Dec 21 00:00:00 EST 2018 


Popcorn left unattended, microwave on 


fire Qo 


Mon Apr 01 00:00:00 EDT 2019 


图 18-7 应 用 工具 栏 标题 已 聚焦 

向 右 滑 屏 ，TalkBack 又 读 出 了 新 建 crime 按 钮 的 相关 人 信息。 继续 右 滑 ， 将 
辅助 焦点 移动 到 第 一 条 crime 记 录 上 。 现 在 向 左 滑 ， 辅 助 焦 点 又 移 回 到 
了 新 建 crime 按 钮 。 总 之 ，Android 会 智能 有 序 地 移动 辅助 焦点 。 这 就 是 
TalkBack 的 线性 浏览 。 

18.2 ”实现 非 文 字 型 元 素 可 读 


现在 ， 点 击 工具 栏 上 添加 新 crime 的 按钮 ， 让 其 聚焦 ， 等 TalkBack 读 完 按 
钮 相关 信息 后 ， 连 点 屏幕 任意 地 方 ， 进入 crime 明 细 页 面 。 


18.2.1 添加 内 容 描 述 


在 crime 明 细 页 面 ， 点 击 聚 焦 拍 照 按 钮 ， 如 图 18-8 所 示 。TalkBack 开 腔 
了 :“ 按 钮 没 文字 ， 连 点 两 下 可 激活 它 。”( 设 备 系统 版 本 不 同 ， 结 果 可 


能 稍 有 出 入 。) 


9:00 


按钮 没 文字 Criminallntent 
4 , 
连 点 两 下 可 激活 它 。 


DETAILS 
TUE MAR 12 21:03:04 EDT 2019 
E Solved 


CHOOSE SUSPECT 


SEND CRIME REPORT 


图 18-8 ”拍照 按钮 已 聚焦 


操 照 按钮 无 文字 描述 ， 除 了 告诉 用 户 连 扣 两 下 油 活 ，TalkBack 没 什么 好 
说 的 。 显 然 ， 这 对 于 视力 有 障碍 的 人 来 说 ， 并 没有 多 大 用 处 。 


没关系 ， 有 办 法 解决 。 我 们 可 以 给 ImageButton 添 加 内 容 描 述 ， 这 样 

TalkBack 就 有 内 容 可 读 了 。 内 容 摘 述 是 一 段 针 对 部 件 的 文字 说 明 ， 供 

TalkBack 朗 读 。【〔 借 处 理 拍照 按钮 的 机 会 ， 一 并 给 ImageView 预 览 照片 
部 件 添加 内 容 描 述 。) 


要 给 部 件 添加 内 容 描 述 ， 可 以 在 部 件 的 布局 XML 文 件 里 ， 添 

加 android:contentDescription 属 性 。 当 然 ， 也 可 以 在 布局 实例 化 
RAG 8, 48 A someView. setContentDescription(someString) rf 
数 。 这 两 种 方式 ， 稍 后 都 会 尝试 。 
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然 他 们 可 以 调 快 天 读 速度 ， 但 简洁 的 文字 能 节约 用 户 的 时 间 。 像 “部 件 
是 什么 类 型 ”这 种 信息 ，TalkBack 会 自动 提供 ， 完 全 没 必 要 写 在 内 容 插 
述 里 。 


参照 代码 清单 18-1， 打 开 无 资源 修饰 符 的 res/values/strings.xml 文 件 ， 
为 ImageButton 和 ImageView 添 加 内 容 描述 。 


代码 清单 18-1 添加 内 容 描述 字符 串 (res/values/strings.xml) 


<resources> 


«string name-"crime details label">Details</string> 
«string name-"crime solved label"»Solved«/string» 
«string name-"crime photo button description"»Take photo of crime scene 


«string name-"crime photo no image description"» 
Crime scene photo (not set) 
«/string» 
«string name-"crime photo image description" »Crime scene photo (set)«/s 


</resources> 


Android Studio Z5 3r JUAN FF BAT E FRR, ero, f REX 
文 版 本 的 字符 串 资 源 。 为 了 修正 问题 ， 打 开 res/values-zh/strings.xml 广 
件 ， 为 ImageButton 和 ImageView 添 加 中 文 内 容 描 述 ， 如 代码 清单 18-2 
所 示 。 


代码 清单 18-2 YSU PICA AIA EP 《res/values- 


zh/strings.xml ) 


<resources> 


«string name-"crime details label">Details</string> 

«string name-"crime solved label"»Solved«/string» 

«string name-"crime photo button description"» 
陋习 现场 拍照 按钮 

</string> 

«string name-"crime photo no image description"» 
陋习 现场 照片 (未 拍照 ) 

</string> 

«string name-"crime photo image description"» 

陋习 现场 照片 (已 拍照 ) 

</string> 


</resources> 


然后 ， 打 开 res/layout/fragment_crime.xml 文 件 ， 参 照 代 码 清单 18-3， 为 
ImageButton 设 置 内 容 描 述 。 


代码 清单 18-3 ”为 ImageButton 设 置 内 容 描述 
(res/layout/fragment_crime.xml ) 


<ImageButton 
android: id="@+id/crime_camera” 
android: layout_width="match_parent" 


android: layout_height="wrap_content" 
android: src="@android:drawable/ic_menu_camera” 
android: contentDescription="@string/crime_photo_button_description" /> 


运行 CriminalIntent 应 用 ， 聚 焦 哲 照 按 钮 ，TalkBack 开 始 朗 读 :“ 陋 习 现 
场 拍照 按钮 ， 连 点 两 下 激活 。” 这 下 ， 用 户 总 算 明 白 了 。 


接 下 来 ， 点 击 照片 预览 处 〈 当 前 显示 的 是 灰色 占 位 图 ) 。 你 可 能 以 为 辅 
助 聚 焦 框 会 上 移 ， 但 聚焦 框 包围 了 整个 fragment 视 图 区 域 ， 而 并 非 移 
到 ImageView 部 件 上 。 而 且 ，TalkBack 什 么 也 没 说 。 问 题 出 在 哪里 ? 


18.2.2 ”实现 部 件 可 聚焦 


原来 ，ImageView 部 件 没 有 做 可 聚焦 登记 。 有 些 框架 部 件 ， 比 如 
Button， 默 认 是 可 聚焦 的 ;而 像 ImageView 这 样 的 框架 部 件 需 要 手动 
登记 。 设 置 android:focusable 属 性 值 为 true 或 使 用 监听 器 都 可 以 让 
这 些 部 件 可 聚焦 。 也 可 以 添加 android:contentDescription， 让 部 
件 可 聚焦 。 


如 代码 清单 18-4 所 示 ， 登 记 ImageView 为 可 聚焦 部 件 。 


代码 清单 18-4 ”让 ImageView 可 聚焦 
(res/layout/fragment_crime.xml ) 


<ImageView 
android: id="@+id/crime_photo" 


android: background="@android:color/darker_gray" 
android: contentDescription="@string/crime_photo_no_image description" 


运行 CriminalIntent 应 用 ， 点 击 crime 缩 略图 部 件 ，ImageView 终 于 可 聚焦 
了 。 如 图 18-9 所 示 ，TalkBack 读 道 : “crime 陋习 现场 照片 ， 当 前 未 拍 


H8 » 
4v VO 


9:00 


Criminallntent 


TITLE 
Enter a title for the crime 


crimes 3] Z3; H8 Hr, 


当前 未 拍照 。 


[9] 
DETAILS 


TUE MAR 12 21:03:04 EDT 2019 


[C] Solved 


CHOOSE SUSPECT 


SEND CRIME REPORT 


图 18-9 可 聚焦 的 ImageView 


18.3 ”提升 辅助 体验 


有 些 UI 部 件 ， 比 如 ImageView， 虽 然 会 给 用 户 提供 一 些 信 息 ， 但 没有 文 
字 性 内 容 。 你 也 应 该 给 这 些 部 件 添 加 内 容 描述 。 如 果 某 个 部 件 提供 不 了 
任何 有 意义 的 说 明 ， 应 该 把 它 的 内 容 描述 设置 为 nul1， 让 TalkBack 直 接 
你 可 能 会 认为 ， 既 然 用 户 看 不 见 ， 是 不 是 图 片 有 什么 关系 呢 ? 知道 了 又 


Ap? 这 种 想法 不 对 。 作 为 开 及 人 员 ， 理 应 让 所 有 用 户 都 能 用 到 应 用 的 
全 部 功能 ， 获 得 同样 的 信息 。 即 便 不 同 ， 那 也 应 该 是 自身 体验 和 使 用 方 


式 上 的 差异 。 


好 的 辅助 易 用 设计 不 是 一 字 不 漏 地 读 屏幕 。 相 反 ， 应 注重 用 户 体验 的 一 
致 性 。 重 要 的 信息 和 上 下 文 一 定 要 全 部 传达 。 


现在 ，crime 预 吃 图 就 给 了 用 户 不 好 的 体验 。 即 使 有 照片 ，TalkBack 也 总 
说 当前 未 拍照 。 现 在 我 们 一 起 感受 一 下 。 点 击 拍照 按 钮 ， 然 后 连 点 屏幕 
两 下 激活 ， 相 机 应 用 启动 了 ，TalkBack 说 道 : “拍照 。” 点 击 并 激活 快门 
按钮 拍摄 一 张 照 


确认 所 拍照 片 。 EP MN 步 又， 不 同 的 相机 应 用 可 能 有 不 同 的 操作 。 
但 不 管 怎样 ， 邦 古 先 到 察 焦 ， 再 连 点 两 下 激活 。) crime 明 细 页 面 现 在 显 
示 了 刚 拍 的 照片 。 聚 焦 ImageView 视 图 ，TalkBack 读 道 : “crime 陋习 现 
场 照片 ， 当前 未 拍照 3 


为 了 解决 这 个 问题 ， 让 用 户 能 听 到 正确 信息 ， 在 updatePhotoView() 
函数 里 动态 设置 ImageView 的 内 容 描述 ， 如 代码 清单 18-5 所 示 。 


代码 清单 18-5 ”动态 设置 内 容 描述 〈CrimeFragment.kt) 


class CrimeFragment : Fragment() { 


private fun updatePhotoView() { 
if (photoFile.exists()) ( 
val bitmap = getScaledBitmap(photoFile.path, requireActivity()) 
photoView.setImageBitmap(bitmap) 
photoView.contentDescription - 
getString(R.string.crime photo image description) 


) else { 
photoView.setImageDrawable(null) 
photoView.contentDescription - 
getString(R.string.crime photo no image description) 


现在 ， 只 要 有 照片 更 新 ，updatePhotoVview() 函 数 都 会 设置 内 容 描 
IR m puse 内 容 摘 述 会 说 明 没 拍照 片 ， 否 则 歌 明 确 说 
明 已 拍照 。 


运行 CriminalIntent 详 用 ， 查 看 刚 拍 过 照 的 Crime 明 细 页 面 。 如 图 18-10 所 
示 ， 点 击 图 片 聚 焦 ， 这 次 ，TalkBack 说 道 : “crime 陋习 现场 照片 ， 当 前 
已 拍照 。” 
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Criminallntent 


crimes 3] ZH; H8 Hr, 
当前 已 拍照 。 


DETAILS 
TUE MAR 12 21:03:04 EDT 2019 
E Solved 


CHOOSE SUSPECT 


SEND CRIME REPORT 


图 18-10 ”和 带动 态 描 述 的 可 聚焦 ImageView 


恭喜 ! 现在 应 用 的 易 用 性 有 了 很 大 改善 。 很 多 开发 人 员 总 是 找 借口 说 ， 
对 辅助 功能 这 块 不 熟悉 ， 所 以 不 愿 为 特殊 人 群 提高 应 用 的 易 用 性 。 你 看 
到 了 ， 让 应 用 更 好 地 支持 TalkBack 并 没 那 么 难 。 而 且 ， 有 了 改善 
TalkBack 的 基础 和 经 验 ， 就 更 容易 学 会 改善 其 他 辅助 功能 了 ， 比 如 
BrailleBack. 


设计 和 实现 市 辅助 功能 的 应 用 容易 让 人 望而却步 。 要 知道 ， 在 这 个 领 

域 ， 可 是 有 很 多 专职 工程 师 的 。 不 过 ， 与 其 害怕 做 不 好 而 直接 忽略 ， 不 
如 从 基本 做 起 : 确保 将 屏幕 上 有 意义 的 信息 都 传达 给 TalkBack 用 户 ; w 
保 给 予 TalkBack 用 户 充 分 的 上 下 文 信息 。 不 要 让 用 户 浪 费时 间 听 废话 。 

当然 ， 最 重要 的 是 ， 倾 听 用 户 的 声 首 ， 虚 心 学 习 。 


至 此 ，CriminalIntent 尿 用 完成 了 。 历 经 11 章 ， 我 们 创建 了 一 个 复杂 的 应 
用 ， 它 使 用 fragment、 支 持 应 用 间 通 信 、 可 以 拍照 、 可 以 保存 数据 ， 甚 
至 可 以 说 中 文 。 

18.4 深入 学 习 : 使 用 辅助 功能 扫 摘 项 


本 章 ， 我 们 专注 于 让 TalkBack 用 户 更 方便 地 使 用 应 用 。 不 过 ， 这 还 没 结 
束 ， 照 顾 视 力 障碍 人 和 群 只 是 做 了 辅助 工作 的 一 小 部 分 。 


理论 上 ， 测 试 应 用 的 辅助 功能 得 徘 真 正 每 天 在 用 辅助 服务 的 用 户 。 即 使 
现实 不 允许 ， 也 应 竭尽 所 能 。 


为 此 ，Google 提 供 了 一 个 辅助 功能 扫描 器 。 它 能 评估 应 用 在 辅助 功能 方 
面 做 得 如 何 并 给 出 改进 意见 。 现 在 拿 CriminalIntent 应 用 做 个 测试 。 


首先 ， 在 设备 上 安装 辅助 功能 扫描 霹 应 用 ， 如 图 18-11 所 示 。 


Accessibility Scanner R 


Google LLC 
INSTALL 


© Everyone 


Scan accessibility quickly 


READ MORE 


图 18-11 安装 辅助 功能 扫 摘 器 


安装 完成 后 ， 手 机 屏幕 上 会 出 现 一 个 打 钩 图 标 。 好 戏 开 始 了 ， 局 动 
Criminalintent 必 用 ， 先 忽略 打 钩 图 标 ， 直 接 进 入 应 用 的 crime 明 细 页 面 ， 


如 图 18-12 所 示 。 
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图 18-12 ”启动 CriminalIntent 心 用 待 分 析 


点 击 打 钓 图 标 ， 辅 助 功能 扫描 器 开始 工作 。 分 析 时 会 看 到 进度 条 。 一 旦 
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图 18-13 ”辅助 功能 扫描 右 分 析 结 果 


可 以 看 到 EditText 和 CheckBox 都 带 框 。 这 表明 ， 扫 摘 嚣 认为 这 两 个 部 
件 有 潜在 的 辅助 功能 问题 。 点 击 checkBox 查 看 它 的 问题 ， 如 图 18-14 所 


ZN o 


€ Element2 < 


TITLE 
Sticker vandalism 


[©] 
DETAILS 
TUE MAR 12 21:03:04 EDT 2019 
ED solved > 
CHOOSE SUSPECT 
SEND CRIME REPORT 


1 suggestion 
com.bignerdranch. android. criminalintent:id/c.. 


$ Touchtarget ^ 
Consider making this clickable item larger. 
This item's height is 32dp. Consider making the 
height of this touch target 48dp or larger. 


LEARN MORE 


[418-14 “checkBox 辅 助 功能 改进 意见 

辅助 功能 扫描 器 建议 增加 checkBox 的 尺寸 。 对 所 有 人 触摸 类 部 件 ， 推 荐 
的 最 小 尺寸 是 48dp。CheckBox 的 高 度 不 够 ， 这 很 容易 修改 ， 指 定 它 的 
android:minHeight 属 性 就 可 以 了 。 

点 击 LEARN MORE， 可 查看 辅助 功能 扫描 器 给 出 的 更 多 建议 。 


要 关闭 辅 助 功能 扫描 器 ， 前 往 设 置 界 面 ， 点 击 辅助 功能 ， 再 点 击 辅助 功 
能 扫描 器 ， 然 后 使 用 开关 关 措 它 ， 如 图 18-15 所 示 。 


9:00 wai 
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Settings 


@ Accessibility Scanner scans your current screen 
and provides suggestions to improve the 
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* Content labels 
* Touch target size 
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manual testing, and doesnt guarantee an app's 
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Kl18-315 ” 关 挥 辅助 功能 扫描 器 
18.5 PRAT: 优化 列表 项 


在 crime 列 表 页 面 ，TalkBack 会 读 uc) 标题 和 发 生日 期 ， 
[Hiit f crimese A OAR file Tad PS AIA A, AAR 
这 个 问题 。 


对 于 每 条 crime 记 录 ，TalkBack 都 要 花 点 时 间 来 读 ， 这 是 因为 日 期 格式 很 
长 ， 而 且 是 否 已 解决 标志 位 于 最 右边 。 现 在 ， 再 挑战 一 下 自己 ， 为 屏幕 
上 的 每 条 记录 都 动态 添加 一 个 待 读 数据 的 汇总 内 容 描 述 


18.6 ”挑战 练习 : 补 全 上 下 文 信息 


日 期 按钮 和 选择 联系 人 按钮 都 有 类 似 标题 EditText 的 问题 。 无 论 古 否 
使 用 TalkBack， 用 户 都 不 太 明 白带 有 日 期 的 按钮 是 用 来 做 什么 的 。 同 
样 ， 选 了 联系 人 作为 嫌疑 人 后 ， 用 户 也 可 能 不 知道 联系 人 按钮 的 作用 是 
什么 。 用 户 也 许 能 猜测 出 来 ， 但 为 什么 要 让 用 户 猜 呢 ? 


这 就 是 设计 的 微妙 之 处 。 你 或 设计 团队 应 该 拿 出 最 好 的 方案 ,平衡 易 用 
和 简约 的 关系 。 


作为 练习 ， 请 修改 明细 页 面 的 设计 ， 让 用 户 充 分 把 握 数据 和 按钮 间 的 上 
下 文 关 系 。 和 人 处理 EditText 标 题 一 样 ， 你 可 以 为 每 个 部 件 都 添加 label 
标签 。 为 此 ， 你 可 以 为 每 个 按钮 都 添加 TextView 标 签 ， 然 后 使 

用 android:1abelFor 属 性 ， 让 它们 各 自 关 联 起 来 。 


<TextView 
android: id="@+id/crime_date_label" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: text="Date" 


android: labelFor="@+id/crime_date"/> 
<Button 

android: id="@+id/crime_date" 

android: layout_width="match_parent" 

android:layout height-"wrap content" 

tools:text-"Wed Nov 14 11:56 EST 2018"/» 


android:1abelFor 属 性 表明 ， 新 加 的 TextView 就 是 指定 ID 的 视图 的 

标签 。labelFor 定 义 在 View 类 上 ， 因 此 ， 一 个 视图 可 以 和 任何 一 个 视 
图 关联 起 来 ， 让 其 做 自己 的 标签 。 这 里 ， 你 必须 使 用 @+id 语 法 形式 ， 
为 你 所 引用 的 ID 在 当前 文件 里 还 没有 定义 。 现 在 ， 你 可 以 从 EditText 

定义 里 的 android:id="@+id/crime _ title" 这 一 行 移 除 + 符 号 了 。 不 

过 ， 留 着 也 没 问 题 ， 你 自己 看 着 办 吧 。 


18.7 ”挑战 练习 :; 事件 主动 通知 


给 ImageView 添 加 动态 内 容 摘 述 后 ，crime 缩 略图 部 件 的 TalkBack 体 验 获 
得 了 极 大 改善 。 但 是 ，TalkBack 用 户 必须 等 点 击 并 聚焦 ImageView 之 
后 ， 才 知道 照片 是 否 已 拍 或 已 更 新 。 而 视力 正常 的 用 户 在 从 相机 应 用 返 
回 时 就 能 看 到 照片 更 新 情况 。 


你 可 以 提供 类 似 体验 ， 让 TalkBack 用 户 在 相机 关闭 时 就 能 掌握 照片 更 新 
情况 。 查 阅 文档 研究 一 下 View.announceForAccessibility(...) 函 
数 ， 看 看 怎么 在 CriminalIntent 应 用 里 使 用 。 


或 许 你 考虑 过 在 onActivityResult(...) 函 数 里 通知 。 如 果 要 这 样 
做 ， 会 出 现 与 activity 生 命 周 期 相关 的 时 间 点 掌控 方面 的 问题 。 不 过 ， 局 
动 一 个 Runnable〈 详 见 第 25 间 ) ， 做 个 延 时 处 理 可 以 绕 开 这 个 问题 。 
以 下 是 参考 代码 : 


SomeView.postDelayed(Runnable { 
// Code for making announcements here 
}, SOME DURATION IN MILLIS) 


你 也 可 以 避 开 使 用 Runnable， 想 办 法 确定 发 出 通知 的 准确 时 间 点 。 例 
如 ， 可 考虑 在 onResume( ) 函 数 里 通知 。 当 然 ， 前 提 是 ， 你 需要 跟踪 掌 
握 用 户 是 否 刚 从 相机 应 用 退出 。 


19 数据 绑 定 与 MVVM 


本 章 ， 我 们 开始 开发 一 个 名 为 BeatBox 的 新 应 用 ， 如 图 19-1 所 示 。 
BeatBox 不 是 传统 意义 上 的 节拍 盒 ， 而 是 一 个 能 在 拳击 运动 中 帮 你 击败 
对 手 的 神奇 盒子 。 不 过 ， 像 练 得 比 对 方 更 快 更 壮 这 样 的 事 它 帮 不 了 你 ， 
但 它 能 帮 你 做 你 难以 做 到 的 事 : 发 出 调 校 好 的 叫喊 声 吓 得 对 手 届 服 。 


1:42 7.0 


BeatBox 
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[19-1 BeatBox 应 用 完成 图 


在 这 个 项 目 里 ， 我 们 将 学 习 使 用 Jetpack 架 构 组 件 库 中 的 数据 绑 定 〈data 
binding) 工具 ， 并 用 它 实 现 一 个 名 为 Model-View-View 
Model (MVVM) 的 新 架构 。 此 外 ， 还 会 学 习 使 用 资源 系统 Cassets 


system) 存储 声音 文件 。 


19.1 为 何 要 用 MVVM 架 构 


目前 为 止 ， 我们 开发 的 应 用 都 采用 了 简单 版 的 MVC 架 构 。 而 且 ， 如 果 
没 出 什么 丝 漏 ， 应 用 都 运行 展 好 。 那 为 何 要 改变 这 种 架构 昵 ? 有 什么 问 


题 吗 ? 


之 前 实现 的 MVC 架 构 比 较 适 合 小 而 简单 的 应 用 ， 方 便 开 发 人 员 厘 清 项 
目 结构 ， 快 速 添 加 新 功能 ， 为 后 续 开 发 打下 坚实 基础 。 应 用 因此 得 以 快 
速 完 成 并 投入 使 用 ， 而 且 在 项 目的 早期 阶段 能 保持 稳定 运行 。 


相 比 本 书 示例 项 目 ， 你 的 项 目 日 渐 复 杂 ， 问 题 接 是 而 来 。 这 和 真实 项 目 
没什么 两 样 。fragment 和 activity 开 始 膨胀 ， 逐 渐变 得 难以 理解 和 扩展 。 
添加 新 功能 或 修复 bug 需 要 耗费 很 长 时 间 。 事 情 发 展 到 一 定 程度 ， 控 制 
器 层 束 需要 做 功能 拆 分 了 。 


怎么 拆 分 ? 先 搞 清楚 脱 胀 的 控制 器 类 到 底 做 了 哪些 工作 ， 再 把 这 些 工 作 
拆 分 到 独立 的 小 类 里 。 让 一 个 个 拆 开 的 小 类 协同 工作 。 


那么 ， 这 些 不 同 的 工作 该 如 何 确定 和 区 分 呢 ? 应 用 采用 的 架构 可 以 给 你 
答案 。 人 们 高 度 概括 并 总 结 出 了 MVC 和 MVVM 架 构 模 型 。 这 就 是 他 们 
给 出 的 这 个 问题 的 答案 。 无 论 如 何 ， 采 用 什么 样 的 架构 你 自己 最 清楚 ， 
如 何 答题 就 看 你 了 。 


BeatBox 应 用 采用 MVVM 架 构 进 行 设计 和 开发 。 我 们 是 MVVM 架 构 的 粉 
丝 。MVVM 架 构 很 好 地 把 控制 器 里 的 腑 和 肿 代码 抽 到 布局 文件 里 ， 让 开 
发 人 员 很 容易 看 出 哪些 是 动态 界面 。 同 时 ， 它 也 抽出 部 分 动态 控制 器 代 
码 放 入 视图 模型 类 。 这 样 一 来 ， 测 试 和 验证 更 容易 了 。 


每 个 视图 模型 应 控制 成 多 大 规模 ， 需 要 具体 情况 具体 分 析 。 如 宁 视 图 模 
型 过 大 ， 你 还 可 以 继续 拆 分 。 总 之 ， 你 的 架构 你 把 控 。 即 使 大 家 都 用 

人 
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19.2 MVVM View Model 与 Jetpack ViewModel 


开始 新 项 目 之 前 ， 针 对 术语 做 如 下 说 明 : MVVM 中 的 视图 模型 (view 
model) 跟 你 在 第 4 章 和 第 9 章 使 用 的 Jetpack 库 中 的 ViewMode1 类 是 两 个 
不 同 的 概念 。 为 避免 混 消 ， 二 者 在 命名 上 做 如 下 区 分 : 一 个 叫 视图 模 
型 ， 另 一 个 叫 ViewModel。 


你 应 该 还 记得 ，Jetpack ViewMode1 是 一 个 特殊 的 功能 类 ， 可 以 用 来 管理 
和 保留 fragment 和 activity《〈 在 它们 的 生命 周期 状态 发 生变 化 时 ) 里 的 数 
据 。 而 MVVM 里 的 视图 模型 是 架构 方面 的 一 种 概念 。 视 图 模型 当然 可 

以 使 用 Jetpack ViewMode1l 类 来 实现 ， 但 学 完 本 章 你 就 会 知道 ， 不 使 

用 ViewModel 类 也 可 以 。 


19.3 |Æ BeatBox H 
该 动手 了 ， 首 先 我 们 来 创建 BeatBox 应 用 。 


在 Android Studio 中 ， 选 择 File > New > New Project... 荣 单项 创建 新 项 
目 。 确 认 选 中 Phone and Tablet 选 项 页 和 Empty Activity， 项 目 名 称 是 
BeatBox， 包 名 是 com.bignerdranch.android.beatbox， 记 得 勾 选 Use 
AndroidX artifacts， 其 余 默认 项 保持 不 变 ， 完 成 项 目 创建 。 


MainActivity 会 在 RecyclerView 里 显示 一 排 按 钮 。 因 此 ， 还 要 在 
app/build.gradle X: (4 48 Ilandroidx.recyclerview:recyclerview: 1.0.04 $ 
项 ( 别 忘 了 同步 文件 ) 。 然 后 ， 参 照 代码 清单 19-1， 使 

用 RecyclervView 部 件 定义 替换 res/layoutUactivity_main.xml 里 的 默认 布局 


代码 清单 19-1 更 新 MainActivity 的 布局 文件 


(res/layout/activity_main.xml ) 


<androidx.recyclerview.widget.RecyclerView 
xmlns: android="http: //schemas.android.com/apk/res/android" 
android: id="@t+tid/recycler_view" 
android: layout_width="match_parent" 
android:layout height-"match parent" /> 


运行 应 用 ， 你 会 看 到 一 个 大 空 屏 。 此 时 可 以 松 一 口气 了 ， 新 项 目 初 见 成 
效 。 给 自己 打 个 气 ， 准 备 学 习 数 据 绑 定 新 知识 吧 。 
19.4 ”实现 简单 的 数据 绑 定 


接 下 来 的 任务 是 配置 使 用 RecyclerView。 这 个 任务 之 前 做 过 。 这 次 ， 

我 们 使 用 数据 绑 定 来 快速 搞定 。 

使 用 数据 绑 定 处 理 布局 有 几 个 优点 ， 会 让 开发 更 轻松 。 束 本 节 的 简单 用 
例 来 看 ， 无 须 调用 findViewById(...)， 你 也 能 引用 视图 。 稍 后 ， 你 
会 看 到 数据 绑 定 更 高 级 的 用 处 ， 比 如 帮助 实现 MVVM 架 构 。 


首先 ， 在 应 用 的 build.gradle 文 件 里 ， 通 过 应 用 kot1lin-kapt 插 件 ， 启 用 
数据 绑 定 ， 如 代码 清单 19-2 所 示 。 


代码 清单 19-2 ”局 用 数据 绑 定 (app/build.gradle) 


apply plugin: 'kotlin-kapt' 


android { 
buildTypes { 
j 


dataBinding { 
enabled = true 


HM 
) 

应 用 kotlin-kapt 插 件 后 ， 数 据 绑 定 就 可 以 执行 Kotlin 注 解 处 理 了 。 这 
很 重要 ， 原 因 稍 后 解释 。 


要 在 布局 文件 里 使 用 数据 绑 定 ， 首 先 要 把 一 般 布 局 改造 为 数据 绑 定 布 
局 。 具 体 做 法 是 把 整个 布局 定义 放 入 <1layout> 标 签 ， 如 代码 清单 19-3 
AAR o 


代码 清单 19-3 ”把 一 般 布 局 改造 为 数据 绑 定 布局 


(res/layout/activity_main.xml ) 


«layout xmlns:android-"http://schemas.android.com/apk/res/android"» 
<androidx.recyclerview.widget.RecyclerView 


android: id="@+id/recycler_view" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 


</layout> 


<1ayout> 标 签 告诉 数据 绑 定 工具 : “这 个 布局 应 该 由 你 来 处 理 。” 接 到 
任务 ， 数 据 绑 定 工具 会 帮 你 生成 一 个 绑 定 类 Cbinding class) 。 新 生成 
的 绑 定 类 默认 以 布局 文件 命名 ， 再 加 个 Binding 后 级 。 不 过 ， 命 名 格式 
不 是 蛇 形 式 命 名 (snake_case) ， 而 是 驼峰 式 命 名 (CamelCase) 。 


现在 ，activity_main.xml 已 经 有 了 一 个 名 为 ActivityMainBinding 的 绑 
定 类 。 这 就 是 要 用 来 做 数据 绑 定 的 类 : 现在 ， 无 须 使 

用 setContentView(Int) 实 例 化 视图 层级 结构 ， 我 们 转 而 实例 

化 ActivityMainBinding 类 。 在 一 个 名 为 root 的 属性 

里 ，ActivityMainBinding 引 用 着 布局 视图 结构 ， 而 且 也 会 引用 那些 
在 布局 文件 里 以 android:id 标 签 引用 的 其 他 视图 。 


所 以 ，ActivityMainBinding 类 有 两 个 引用 : Foot 和 
recyclerView， 其 中 前 者 指 整 个 布局 ， 后 者 指 RecyclerView， 如 图 
19-2 所 示 。 


ActivityMainBinding 


getRoot0 recyclerView 


RecyclerView 


图 19-2 ” ActivityMainBinding 绑 定 类 


你 的 布局 只 有 一 个 视图 ， 所 以 两 个 引用 都 指向 了 同一 个 视 
图 : RecyclerView. 


下 面 开 始 使 用 这 个 绑 定 类 。 在 MainActivity 里 ， 才 盖 
onCreate(Bundle?) 函 数 ， 然 后 使 用 DataBindinguti1 实 例 
化 ActivityMainBinding， 如 代码 清单 19-4 所 示 。 


代码 清单 19-4 实例 化 绑 定 类 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


tContentView(R.] ei 


val binding: ActivityMainBinding = 
DataBindingUtil.setContentView(this, R.layout.activity_main) 


你 需要 导入 ActivityMainBinding 类 。 如 果 Android Studio 提 示 找 不 
到 ， 说 明 由 于 某 种 原因 ，ActivityMainBinding 没 有 正常 生成 。 遇 到 
这 种 情况 ， 请 尝试 重新 编译 项 目 或 重启 Android Studio. 


实例 化 绑 定 类 后 ， 就 可 以 获取 并 配置 RecyclerView 了 ， 如 代码 清单 19- 
5 所 示 。 


代码 清单 19-5 配置 RecyclerView (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


val binding: ActivityMainBinding = 
DataBindingUtil.setContentView(this, R.layout.activity_main) 


binding.recyclerView.apply { 
layoutManager = GridLayoutManager(context, 3) 


接 下 来 ， 创 建 按钮 布局 文件 res/layout/ist_item_sound.xml。 这 个 布局 也 
使 用 数据 绑 定 ， 所 以 同样 添加 <1layout> 标 签 ， 如 代码 清单 19-6 所 示 。 


代码 清单 19-6 创建 声音 布局 文件 


(res/layout/list_item_sound.xml ) 


«layout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<Button 
android: layout_width="match_parent" 
android: layout_height="12@dp" 
tools: text="Sound name"/> 
</layout> 


接 下 来 ， 创 建 一 个 使 用 list_item_sound.xml 布 局 的 SoundHolder， 如 代 
码 清单 19-7 所 示 。 


代码 清单 19-7 创建 SoundHolder (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


private inner class SoundHolder(private val binding: ListItemSoundBindi 
RecyclerView.ViewHolder(binding.root) { 


} 


SoundHolder 要 使 用 刚才 数据 绑 定 工具 生成 的 绑 定 


类 : ListItemSoundBinding. 
接着 ， 创 建 一 个 关联 soundHolder 的 Adapter， 如 代码 清单 19-8 所 示 。 


代码 清单 19-8 创建 soundAdapter (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private inner class SoundHolder(private val binding: ListItemSoundBindi 
RecyclerView.ViewHolder(binding.root) { 


} 


private inner class SoundAdapter() : 
RecyclerView.Adapter<SoundHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): 

SoundHolder { 

val binding = DataBindingUtil.inflate<ListItemSoundBinding>( 
layoutInflater, 
R.layout.list item sound, 
parent, 
false 

) 

return SoundHolder(binding) 


} 


override fun onBindViewHolder(holder: SoundHolder, position: Int) { 


} 


override fun getItemCount() = @ 


最 后 ， 在 onCreate(Bundle? ) 函 数 中 使 用 SoundAdapter， 如 代码 清单 
19-9 所 示 。 


代码 清单 19-9 使 用 SoundAdapter (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


val binding: ActivityMainBinding = 
DataBindingUtil.setContentView(this, R.layout.activity_main) 


binding.recyclerView.apply { 
layoutManager = GridLayoutManager(context, 3) 
adapter = SoundAdapter() 

} 


} 


现在 ， 你 然而 ， 它 还 没 东 西 可 
以 显示 。 下 一 节 ， 我 们 会 把 一 些 声音 文件 交 给 它 ， 解 雇 数 据 显示 问题 。 


19.5 & Aassets 


首先 ， 需 要 把 声音 文件 添加 到 项 目 里 ， 以 便 应 用 调用 。 不 过 ， 这 里 不 打 
算 用 资源 系统 ， 我 们 改 用 assets 打 包 声 音 文件 。 可 以 把 assets 想 象 为 经 过 
精简 的 资源 : 它们 也 像 资 源 那样 打 入 APK 包 ， 但 不 需要 配置 系统 工具 管 
HE. 


使 用 assets 有 两 面 性 ， 优 缺点 并 存 : 一 方面 ， 无 须 配 置 系统 管理 ， 可 以 
随意 命名 assets， JHEH CHIF HAREA]: 另 一 方面 ， 没 有 配置 
系统 管理 ， 无 法 目 动 啊 应 屏幕 显示 密度 、 话 言 这 样 的 设备 配置 变更 ， 上 自 
然 也 就 无 法 在 布局 或 其 他 资源 里 自动 使 用 它们 了 。 


总 体 上 讲 ， 资 源 系统 是 更 好 的 选择 。 然 而 ， 如 果 只 想 在 代码 中 直接 调用 
文件 ， 那 么 assets 台 有 优势 了 。 大 多 数 游戏 束 是 使 用 assets 加 载 大 量 图 片 
和 声音 资源 ，BeatBox 也 这 样 。 


现在 我 们 来 导入 assets。 首 先 创 建 assets 目 录 。 右 键 单 击 app 模 块 ， 选 择 
New > Folder > Assets Folder 亲 单项， 这 会 弹出 如 图 19-3 所 示 的 画面 。 
不 勾 选 Change Folder Location 选项， 保持 Target Source Set 的 main 选 项 不 
变 ， 然 后 点 击 Finish 按 钮 完成 。 


eoe New Android Component 


Configure Component 
/以 Android Studio 


Creates a source root for assets which will be included in the APK. 


Q Change Folder Location 


Target Source Set: — main iy 


Change the folder location to another folder within the module. 
_ Cancel | Previous Next a3 
图 19-3 ”创建 assets 目 录 


接着 ， 碳 键 单 击 assets 目 录 ， 选 择 New > Directory k P, WERA 
创建 sample_sounds 子 目录 ， 如 图 19-4 所 示 。 


外 OO@ New Directory 


* Enter new directory name: 
an 


sample sounds 
[ Cancel | (OK) 
图 19-4 创建 sample_sounds 子 目录 
assets 目 录 中 的 所 有 文件 都 会 随 应 用 打包 。 为 了 方便 组 织 文件 ， 我 们 创 
建 了 sample_sounds 子 目录 。 与 资源 不 同 ，assets 一 般 不 需要 子 目 录 。 我 
们 这 人 么 做 是 为 了 组 织 声音 文件 。 
声音 文件 去 哪里 找 呢 ? 在 FreeSound 网 站 。plagasul 是 这 个 网 站 的 用 户 ， 


基于 创作 共用 许可 ， 他 发 布 了 一 套 声音 文件 。 我 们 已 重新 打包 提供 。 
下 载 并 解压 缩 文件 至 assets/sample_sounds 目 录 ， 如 图 19-5 所 示 。 


(i Android ~ O =| He Ir 
s. app 
| manifests 
B java 
^x. generatedJava 


sample sounds 

a 65 cjipie.wav 

2 66 indios.wav 

a 67 indios2.wav 

2 68 indios3.wav 

2 69 ohm-loko.wav 
a 70 eh.wav 

2 71 hruuhb.wav 


图 19-5 已 导入 的 assets 
《确保 这 里 只 有 .wav 文 件 ， 而 非 .zip 压 缩 文 件 。) 


确保 一 切 正 党 。 接 下 来 编写 代码 ， 列 出 这 些 资源 并 展示 
给 用 户 


19.6 ”人 处理 assets 


assets 导 入 后 ， 还 要 能 在 应 用 中 定位 、 管 理 以 及 播放 。 这 需要 新 建 一 个 
名 为 BeatBox 的 资源 管理 类 。 如 代码 清单 19- 10 所 示 ， 在 

com. bignerdranch. android.beatbox 包 中 创建 这 个 类 ， 并 添加 两 个 常量 : 一 
个 用 于 日 志 记 录 ， 男 一 个 用 于 存储 声 音 资源 文件 目录 名 。 


代码 清单 19-10 创建 BeatBox 类 (BeatBox.kt) 


private const val TAG = "BeatBox" 
private const val SOUNDS FOLDER = "sample sounds" 


class BeatBox { 


} 


AssetManager 类 可 以 访问 assets。 你 可 以 从 Context 中 获取 它 。 既 
然 BeatBox 需 要 ， 不 妨 添 加 一 个 接受 AssetManager 参 数 并 留存 它 的 构 
造 函 数 ， 如 代码 清单 19-11 所 示 。 


代码 清单 19-11 获取 AssetManager 备 用 (BeatBox.kt) 


private const val TAG = "BeatBox" 
private const val SOUNDS FOLDER = "sample sounds" 


class BeatBox(private val assets: AssetManager) { 


} 


通常 ， 在 访问 assets 时 ， 不 用 关心 究竟 使 用 哪个 Context 对 象 。 这 是 因 
为 ， 在 实际 开发 中 ， 就 你 遇 到 的 场景 来 说 ， 所 有 Context 的 
AssetManager 都 管理 着 同一 套 assets 资 源 。 


要 获得 assets 中 的 资源 清单 ， 可 以 使 用 list(String) 函 数 。 如 代码 清单 
19-12 所 示 ， 编 写 一 个 名 为 1oadSsounds() 的 函数 ， 调 用 它 给 出 声音 文件 
清单 。 


代码 清单 19-12 ”查看 assets 资 源 (BeatBox.kt) 


class BeatBox(private val assets: AssetManager) { 


fun loadSounds(): List<String> { 
try { 
val soundNames = assets.list(SOUNDS_FOLDER)!! 
Log.d(TAG, "Found ${soundNames.size} sounds") 
return soundNames.asList() 


} catch (e: Exception) { 
Log.e(TAG, "Could not list assets", e) 
return emptyList() 


AssetManager.1list(String) 函 数 能 列 出 指定 目录 下 的 所 有 文件 名 。 
因此 ， 只 要 传 入 声音 资源 所 在 的 目录 ， 就 能 看 到 其 中 的 所 有 .wav 文 件 。 


为 验证 代码 逻辑 可 行 ， 在 MainActivity 中 创建 一 个 BeatBox 实 例 ， 并 


调用 loadsounds() 函 数 ， 如 代码 清单 19-13 所 示 。 


代码 清单 19-13 ”创建 一 个 BeatBox 实 例 CMainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var beatBox: BeatBox 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


beatBox - BeatBox(assets) 
beatBox.loadSounds() 


val binding: ActivityMainBinding - 
DataBindingUtil.setContentView(this, R.layout.activity main) 


binding.recyclerView.apply ( 
layoutManager - GridLayoutManager(context, 3) 
adapter = SoundAdapter() 


运行 BeatBox 应 用 。 奉 看 日 志 输 出 ， 看 看 列 出 了 多 少 个 声音 文件 。 随 书 
文件 中 提供 了 22 个 .wav 文 件 ， 你 应 该 看 到 如 下 结 末 。 


...1823-1823/com.bignerdranch.android.beatbox D/BeatBox: Found 22 sounds 


19.7 使 用 assets 

获取 到 资源 文件 名 之 后 ， 要 显示 给 用 户 看 ， 最 终 还 需要 播放 这 些 声音 文 
件 。 因 此 ， 你 需要 创建 一 个 对 象 ， 让 它 管 理 声音 资源 文件 名 、 用 户 可 见 
文件 名 以 及 其 他 一 些 相 关 信 息 。 

创建 一 个 这 样 的 Sound 管 理 类 ， 如 代码 清单 19-14 所 示 。 


代码 清单 19-14 创建 sound 对 象 (Sound.kt) 


private const val WAV = ".wav" 


class Sound(val assetPath: String) { 


val name = assetPath.split("/").last().removeSuffix (WAV) 


为 了 有 效 显 示 声 音 文件 名 ， 在 构造 函数 中 对 它们 做 一 下 处 理 。 首 先 使 
用 String.split(String).1ast() 函 数 分 离 出 文件 名 ， 再 使 
用 String.removeSuffix(String) 函 数 删 除 .wav 后 级 。 


接 下 来 ， 在 BeatBox. loadSsounds() 函 数 中 创建 一 个 Sound 对 象 集合 ， 
如 代码 清单 19-15 所 示 。 


代码 清单 19-15 ”创建 sound 对 象 集合 (BeatBox.kO 


class BeatBox(private val assets: AssetManager) { 


val sounds: List<Sound> 
init { 
sounds = loadSounds() 


} 


fun loadSounds(): 


——List«Sound» { 
val soundNames: Array<String> 


try { 


— —wval 
—— soundNames = assets.list(SOUNDS FOLDER)!! 


) catch (e: Exception) { 
Log.e(TAG, "Could not list assets", e) 


return emptyList() 
} 
val sounds = mutableListOf<Sound>() 
soundNames.forEach { filename -> 
val assetPath = "$SOUNDS FOLDER/$filename" 
val sound = Sound(assetPath) 
sounds.add(sound) 


) 


return sounds 


再 让 SoundAdapter 与 Sound 对 象 集合 关联 起 来 ， 如 代码 清单 19-16 所 
示 。 


代码 清单 19-16 ” 绑 定 Sound 对 象 集合 (MainActivity.kt) 


private inner class SoundAdapter(private val sounds: List<Sound>) : 
RecyclerView.Adapter<SoundHolder>() { 


override fun onBindViewHolder(holder: SoundHolder, position: Int) { 


} 


override fun getItemCount() = @sounds.size 


现在 ， 在 onCreate(Bundle?) 函 数 中 传 入 BeatBox 声 音 资 源 ， 如 代码 清 
单 19-17 所 示 。 


代码 清早 19-17 传 入 声音 资源 (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


binding.recyclerView.apply { 


layoutManager = GridLayoutManager(context, 3) 
adapter = SoundAdapter(beatBox.sounds) 


最 后 ， 删 除 onCreate 中 的 BeatBox.1loadSsounds() 函 数 ， 如 代码 清单 
19-18 上 所 示 。 


代码 清单 19-18 删除 BeatBox.1oadSounds() (MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 


beatBox = BeatBox(assets) 


既然 BeatBox.1oadSsounds() 函 数 只 在 BeatBox 的 初始 化 块 里 调用 ， 那 
它 的 public 外 部 可 见 性 就 不 需要 了 。 为 了 遵循 编码 规范 ， 避 免 外 部 其 
他 代码 意外 调用 ， 我 们 把 该 函数 的 可 见 性 修饰 符 改 为 private， 如 代码 
清单 19-19 所 示 。 


代码 清单 19-19 ”修改 BeatBox.1oadSounds() 的 外 部 可 见 性 
( BeatBox.kt) 


class BeatBox(private val assets: AssetManager) { 


private fun loadSounds(): List<Sound> { 


j 


现在 ， 运 行 BeatBox 应 用 ， 可 以 看 到 满 是 按钮 的 网 格 出 现 了 ， 如 图 19-6 
FAR e 


7:31 ü 


BeatBox 


图 19-6 ”光秃秃 的 按钮 
要 显示 按钮 文字 ， 还 需要 使 用 新 的 数据 绑 定 小 工具 。 


19.8 绑 定 数据 
使 用 数据 绑 定 ， 我 们 还 可 以 在 布局 文件 中 声明 数据 对 象 ， 


«layout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools"» 
«data» 
«variable 
name="crime" 
type="com.bignerdranch. android. criminalintent.Crime"/> 
</data> 


</layout> 


然后 ， 使 用 绑 定 双 大 括号 (binding mustache) 操作 符 @{}， 就 可 以 在 布 
局 文件 中 直接 使 用 这 些 数据 对 象 的 值 : 


<CheckBox 
android:id="@+id/list item crime solved check box" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android: checked="@{crime.isSolved()}" 
android: padding="4dp"/> 


在 对 象 关系 图 中 ， 可 以 如 图 19-7 这 样 表示 。 


布局 文件 一 一 Kotlin 对 象 


图 19-7 WERA 


我 们 的 目标 是 在 按钮 上 显示 声音 文件 名 。 使 用 数据 绑 定 ， 最 直接 的 方式 
了 怠 是 绑 定 list_item_sound.xml 布 局 文件 中 的 Sound 对 象 ， 如 图 19-8 所 示 。 


list_item_sound.xml —— Sound 


图 19-8 直接 绑 定 


然而 ， 这 似乎 有 架构 方面 的 问题 。 首 先 从 MVC 视 角 看 看 问题 出 在 哪 
儿 ， 如 图 19-9 所 示 。 


视图 模型 


list_item_sound.xml 一 一 Sound 


控制 器 


图 19-9 割裂 的 MVC 


不 管 是 哪 种 架构 ， 都 有 一 个 指导 原则 : 责 任 单一 性 原则 。 也 区 是 说 ， 
个 类 应 该 只 负责 一 件 事情 。 按 此 原则 ，MVC 是 这 样 落实 的 ; 模型 表明 
应 用 如 何 工作 ;控制 器 决定 如 何 显示 应 用 ; 视图 显示 你 想 看 到 的 结果 。 


使 用 如 图 19-8 所 示 的 数据 绑 定 ， 束 违反 了 责任 划分 原则 ， 因 为 Sound 模 
型 对 象 不 可 避免 地 需要 关心 显示 问题 。 很 快 ， 代 码 也 就 此 开始 混乱 了 。 
不 断 添 加 的 模型 层 代 码 和 控制 占 层 代码 都 扎堆 到 Sound.kt 里 。 


为 了 避免 像 Sound 这 样 破坏 单一 性 原则 的 情况 ， 我 们 引入 一 种 名 为 视图 
模型 的 新 对 象 来 配合 数据 绑 定 使 用 。 这 种 新 视图 模型 负责 准备 视图 要 显 
示 的 数据 ， 如 图 19-10 所 示 。 


视图 视图 模型 模型 


list_item_sound.xml — SoundViewModel — Sound 


了 


可 见 属 性 回调 和 监听 器 


19-10 MVVM 


这 种 架构 就 是 我 们 之 前 说 的 MVVM。 从 前 控制 器 对 象 格式 化 视图 数据 
的 工作 融 园 给 了 视图 模型 对 象 。 现 在 ， 使 用 数据 绑 定 ， 部 件 关 联 数据 就 


能 直接 在 布局 文件 里 处 理 了 。 从 前 的 控制 器 对 象 〈activity 或 fragment) 
开始 负责 初始 化 布局 绑 定 类 和 视图 模型 对 象 同时 也 是 它们 之 间 的 联系 
纽 市 。 


MVVM 架 构 里 不 再 需要 控制 器 了 ，Activity 和 fragment 现 在 是 视图 的 一 部 


分 。 


19.8.1 创建 视图 模型 

首先 来 创建 视图 模型 类 。 创 建 一 个 名 为 SoundViewModel 的 新 类 ， 然 后 
添加 两 个 属性 : 一 个 sound 对 象 ， 一 个 播放 声 首 文 件 的 BeatBox 对 象 ， 
如 代码 清单 19-20 所 示 。 


代码 清单 19-20 ”创建 SoundViewModel 类 (SoundViewModel.kt) 


class SoundViewModel { 


var sound: Sound? = null 
set(sound) { 
field = sound 


} 


新 添加 的 属性 是 adapter 要 用 到 的 接口 。 对 于 布局 ， 还 需要 一 个 额外 的 函 
数 来 获取 按钮 要 用 的 文件 名 。 如 代码 清单 19-21 所 示 ， 加 上 这 个 函数 。 


代码 清单 19-21 添加 绑 定 函数 (SoundViewModel.kt) 


class SoundViewModel { 


var sound: Sound? = null 
set(sound) { 
field = sound 


} 


val title: String? 
get() = sound?.name 


19.8.2” 绑 定 至 视图 模型 


现在 ， 把 视图 模型 整合 到 布局 文件 里 。 第 一 步 是 在 布局 文件 里 声明 属 
性 ， 如 代码 清单 19-22 所 示 。 


代码 清单 19-22 ”声明 视图 模型 属性 


(res/layout/list_item_sound.xml ) 


«layout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 


<variable 


name="viewModel" 
type="com.bignerdranch. android. beatbox. SoundViewModel"/> 
</data> 


</layout> 


这 在 绑 定 类 上 定义 了 一 个 名 为 viewMode1l 的 属性 ， 同 时 还 包括 getter 和 
setter 方 法 。 在 绑 定 类 里 ， 可 以 用 绑 定 表达 式 使 用 viewMode1， 如 代码 清 
单 19-23 所 示 。 


代码 清单 19-23 ” 绑 定 按钮 文件 名 (res/layout/list_item_sound.xml ) 


<layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 
<variable 
name-"viewModel" 
type-"com.bignerdranch.android.beatbox.SoundViewModel"/» 


«/data» 
«Button 
android: layout_width="match_parent" 
android: layout_height="12@dp" 
android: text="@{viewModel.title}" 
tools: text="Sound name"/> 
</layout> 


在 绑 定 大 括 写 里 ， 可 以 写 一 些 简单 的 Java 表 达 式 ， 比 如 链 式 函数 调用 、 
数学 计算 等 。 


最 后 一 步 是 关联 使 用 视图 模型 。 创 建 一 个 SoundViewModel， 把 它 添加 
给 绑 定 类 ， 然 后 在 soundHolder 里 添加 一 个 绑 定 函数 ， 如 代码 清单 19- 
24 所 示 。 


代码 清单 19-24 关联 使 用 视图 模型 (MainActivity.kt) 


private inner class SoundHolder(private val binding: ListItemSoundBinding) 
RecyclerView.ViewHolder(binding.root) { 


init { 
binding.viewModel - SoundViewModel() 
} 


fun bind(sound: Sound) ( 
binding.apply { 
viewModel?.sound = sound 
executePendingBindings() 


fESoundHolderj4i&pE Zi HB, RIOEK ARI S ALA a. TA. 
在 绑 定 函数 里 ， 更 新 视图 模型 要 用 到 的 数据 。 


一 般 情 况 下 ， 不 需要 调用 executePendingBindings() 函 数 。 然 而 ， 在 
这 里 ， 我 们 是 在 RecyclerView 里 更 新 绑 定 数据 。 考 虑 到 RecyclerView 
刷新 视图 极 快 ， 我 们 要 让 布局 立即 刷新 ， 一 秒 都 不 想 等 。 这 

样 ，RecyclerView 和 RecyclerView.Adapter 才 能 保持 同步 。 


最 后 ， 实 现 onBindViewHolder(...) 函 数 以 使 用 视图 模型 ， 如 代码 清 
单 19-25 所 示 。 


代码 清单 19-25 ”调用 bind(Sound) 函数 〈MainActivity.kt) 


private inner class SoundAdapter(private val sounds: List<Sound>) : 
RecyclerView.Adapter<SoundHolder>() { 


override fun onBindViewHolder(holder: SoundHolder, position: Int) { 
val sound = sounds[ position] 
holder .bind(sound) 

} 


override fun getItemCount() = sounds.size 
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BeatBox 
65_CJIPIE 66_INDIOS 67_INDIOS2 
68_INDIOS3 69_OHM-LOKO 70_EH 
71. HRUUHB 72. HOUB 73. HOUU 
74_JAH 75_JHUEE 76_JOOOAAH 
77_JUOB 78_JUEB a al 


图 19-11 按钮 上 的 文件 名 出 现 了 
19.8.3” 绑 定数 据 观察 


一 切 看 上 去 很 好 ， 不 过 这 只 是 表面 现象 。 如 图 19-12 所 示 ， 如 果 向 下 滚 
动 按钮 网 格 ， 问 题 就 出 现 了 。 


67_INDIOS2 81_UEHEA 82_UHRAA 


70_EH 65_CJIPIE 66_INDIOS 


73_HOUU 


图 19-12 ”问题 暴露 了 


看 到 最 上 面 一 个 按钮 上 的 “67_ INDIOS” H? 下 面 也 有 一 个 。 上 下 反 
复 深 动 几 次 ， 还 能 看 到 其 他 重复 的 文件 名 ， 具 体位 置 看 样子 是 随机 的 。 
如 果 没 看 到 ， 请 在 设备 横 屏 模式 下 再 试 。 


在 SoundHolder .bind(Sound) 函 数 里 ， 我 们 更 新 了 SoundViewModel 
的 Sound， 但 布局 不 知道 。 而 且 ， 从 图 19-10 可 知 ， 视 图 模型 并 没有 适时 
给 布局 文件 反馈 信息 ， 因 而 出 现 了 上 面 的 问题 。 除 了 清晰 的 责任 划分 ， 
这 一 步 很 关键 ， 是 MVVM 架 构 区 别 于 其 他 架构 (比如 MVC) 的 地 方 
〈《 详 见 19.1 节 ) 。 


现在 任务 明确 了 ， 我 们 需要 让 视图 模型 和 布局 文件 沟通 起 来 。 这 需要 视 
图 模型 实现 数据 绑 定 的 0bservable 接 口 。 这 个 接口 可 以 让 绑 定 类 在 视 
图 模型 上 设置 监听 器 。 这 样 ， 只 要 视图 模型 有 变化 ， 绑 定 类 上 自动 束 收 到 
回调 。 


实现 这 个 接口 理论 上 可 行 ， 但 工作 量 太 大 。 有 没有 其 他 好 办 法 呢 ? 答案 
是 肯定 的 。 现 在 就 一 起 来 看 一 个 简单 的 做 法 《使 用 数据 绑 定 的 


BaseObservablex) 。 


使 用 Base0bservab1le 类 需要 三 个 步骤。 


(1) 在 视图 模型 里 继承 Base0bservab1le 类 。 


(2) 使 用 @Bindable 注 解 视图 模型 里 可 绑 定 的 属性 。 


(3) 每 次 可 绑 定 的 属性 值 改 变 时 ， 就 调用 notifyChange() 
或 notifyPropertyChanged(Int) 函 数 。 


在 SoundViewModel 里 ， 只 有 几 行 代码 。 更 新 SoundViewModel 使 其 可 
见 ， 如 代码 清单 19-26 所 示 。 


代码 清单 19-26 ”使 视图 模型 可 见 (SoundViewModel.kt) 


class SoundViewModel : BaseObservable() { 


var sound: Sound? = null 
set(sound) { 
field = sound 
notifyChange() 


} 


@get:Bindable 
val title: String? 
get() = sound?.name 


这 里 ， 调 用 notifyChange() 函 数 ， 就 是 通知 绑 定 类 ， 视 图 模型 对 象 上 
所 有 可 绑 定 属性 都 已 更 新 。 据 此 ， 绑 定 类 会 再 次 运行 绑 定 表达 式 里 的 代 
码 以 更 新 视图 数据 。 所 以 ，setSound(Sound) 函 数 一 被 调 

用 ，ListItemSoundBinding 立 即 就 会 知道 ， 并 调用 list_item_sound.xml 
布局 里 指定 的 Button.setText(String) 了 函数。 


前 面 提 到 过 另 一 个 函数 :notifyPropertyChanged(Int)。 这 个 函数 
和 notifyCchange() 函 数 做 同样 的 事 ， 但 禾 兰 面 不 一 样 。 调 

用 notifyChange() 函 数 ， 相 当 于 说 : “所 有 的 可 绑 定 属性 都 变 了 ， 请 全 
部 更 新 。” 调 用 notifyPropertyChanged(BR.title) 函 数 ， 相 当 于 
ii: “只 有 getTitle() 函 数 的 值 有 变化 。” 


BR.title 是 数据 绑 定 库 生 成 的 一 个 常量 。BR 类 名 是 binding resource HA 
写 。 使 用 @Bindable 注 解 的 属性 都 会 有 一 个 同名 BR 常量 。 


下 面 是 一 些 其 他 的 例子 : 


@get:Bindable val title: String // 生成 BR.title 


Qget:Bindable val volume: Int // 生 成 BR.volume 
@get:Bindable val etcetera: String // 生 成 BR.etcetera 


你 可 能 想到 ， 使 用 observable 和 使 用 LiveData (〈 详 见 第 11 章 ) BA 
多 。 没 错 ， 事 实 上 ， 本 例 可 以 改 用 LivedData 来 搭配 数据 绑 定 。 那 它们 
有 什么 不 同 ? 有 具体 可 参见 19.10 节 。 


再 次 运行 应 用 。 这 次 ， 无 论 怎么 滚 上 六 下， 都 没 问 题 了 ， 如 图 19-13 所 
Ze 
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图 19-13 ”上 下 滚动 不 会 出 现 问 题 


19.9 深入 学 习 : 数据 绑 定 再 探 


数据 绑 定 可 学 的 还 有 很 多 ， 本 书 无 法 全 部 履 闸 。 不 过 ， 如 果 你 有 兴趣 ， 
多 了 解 一 点 儿 也 无 妨 。 


19.9.1 lambda Ñi È 


在 布局 文件 里 ， 还 可 以 使 用 lambda 表 达 式 写 点 儿 短 回调 。 以 下 是 一 些 简 
化 版 的 Java lambdaz3A X: 


<Button 
android: layout_width="match_parent" 
android: layout_height="12@dp" 


android: text="@{viewModel.title}" 
android: onClick="@{(view) -> viewModel.onButtonClick())" 
tools: text="Sound name"/> 


和 Java 8 lambda 表 达 式 差不多 ， 上 述 表 达 式 会 转 成 目标 接口 实现 (这 里 
是 View.0nClickListener) 。 和 Java 8 lambda 表 达 式 不 同 的 是 ， 这 些 
表达 式 的 语法 有 些 特殊 : 参数 必须 在 括号 里 ， 最 右边 一 定 还 要 有 一 个 表 


另外 ， 还 有 一 点 和 Java 8 lambda 表 达 式 不 同 : 如 果 用 不 到 ，lambda 人 参数 
可 以 不 写 。 下 面 这 个 写法 也 可 以 。 


android: onClick="@{() -> viewModel.onButtonClick()}" 


19.9.2 更 多 语法 糖 


SUE MAH SE VS 的 语法 可 用 。 最 方便 的 一 个 是 使 用 单 引 号 代 蔡 双 
ales 


android: text="@{~ File name: ^ + viewModel.title)" 


XE, ~File name: “和 "File name: "是 一 样 的 。 
绑 定 表达 式 也 有 一 个 nul1 值 合并 操作 符 : 


android:text-"Q( File name: ^ + viewModel.title ?? No file }" 


如 果 title 是 null 值 ，?? 操 作 符 就 返回 "No file" 值 。 


此 外 ， 数 据 绑 定 还 有 null 自 动 处 理 机 制 。 在 上 面 的 代码 中 ， 即 

使 viewMode1 是 nul1 值 ， 数 据 绑 定 也 会 给 出 nul1 值 判断 
(viewModel.title 子 表达 式 会 给 出 "null"〉 ， 保 证 应 用 不 会 因为 这 
^ Ji EAL TID AB 9 © 


19.9.3 BindingAdapter 


数据 绑 定 默认 会 把 绑 定 表达 式 解 读 为 属性 函数 调用 。 因 此 ， 以 下 代码 会 
被 翻译 为 setText (String) MAA. 


android:text="@{ File name: ^ + viewModel.title ?? No file j" 


然而 ， 这 还 不 算 什 么 。 有 时 候 ， 你 可 能 会 想 给 某 些 特别 属性 赋予 一 些 定 
制 行为 。 这 种 情况 下 ， 你 可 以 写 一 个 BindingAdapter: 


@BindingAdapter("app:soundName") 
fun bindAssetSound(button: Button, assetFileName: String ) { 


} 


很 简单 ， 在 项 目的 任何 地 方 创 建 一 个 文件 级 别 的 函数 ， 再 应 用 
@BindingAdapter 注 解 ， 传 入 想 绑 定 的 属性 名 参数 给 注解 ， 传 入 注解 作 
用 到 的 View 作 为 这 个 函数 的 第 一 个 参数 。《〈 和 是 的 ， 这 就 可 以 了 。 ) 


上 例 中 ， 只 要 数据 绑 定 碰 到 带 app:soundName 属 性 〈 含 绑 定 表达 式 ) 
Dees 它 就 传 入 这 个 Button 和 绑 定 表达 式 结果 ， 调 用 你 写 的 函 


你 也 可 以 给 View 或 ViewGroup 这 样 的 顶级 视图 创建 BindingAdapter。 
上 例 中 的 BindingAdapter 就 适用 于 View 及 其 所 有 子 类 。 


例如 ， 如 果 你 想 定 义 一 个 app:isGone 属 性 ， 基 于 某 个 布尔 值 来 设置 所 
有 View 的 可 见 性 ， 可 以 这 么 做 : 


@BindingAdapter("app:isGone") 
fun bindIsGone(view: View, isGone: Boolean ) { 


view.visibility = if (isGone) View.GONE else View.VISIBLE 


} 


因为 View 是 bindIsGone 的 第 一 个 参数 ， 所 以 这 个 属性 就 能 作用 于 app 模 
块 下 的 View 及 其 所 有 子 类 【同样 适用 于 Button、TextView 和 和 
LinearLayout 等 视图 部 件 ) 。 


对 于 标准 库 里 的 部 件 ， 很 可 能 你 也 想 用 数据 绑 定做 点 什么 。 实 际 上 ， 有 
一 些 和 常见 的 操作 已 经 定义 了 绑 定 adapter。 例 
如 ，TextViewBindingAdapter 就 为 TextView 提 供 了 一 些 特别 的 属性 


操作 。 你 可 以 在 Android Studio 里 看 看 它们 的 源码 。 自 己 动手 写 解决 方案 
之 前 ， 不 妨 先 按 Command+Shift+O 〈 或 Ctrl+Shift+O) 搜 一 搜 目 标 类 ， 
打开 其 关联 的 绑 定 adapter 文 件 ， 确 认 无 须 重 复 造 轮子 。 


19.10 深入 学 习 : LiveData 和 数据 绑 定 
LiveData 和 数据 绑 定 用 起 来 很 相似 ， 都 能 实时 观察 数据 变化 ， 及 时 做 


出 反应 。 事 实 上 ， 你 完全 可 以 同时 使 用 LiveDate 和 数据 绑 定 。 下 面 这 
个 例子 就 是 改 用 LiveData 让 soundViewModel 绑 定 title 属 性 。 


class SoundViewModel 


一 一 一 一 Baseg9bsePvable 人 (人 
== 


val title: MutableLiveData<String?> = MutableLiveData() 


var sound: Sound? = null 
set(sound) { 
field = sound 


title.postValue(sound?.name) 


上 例 中 ， 你 不 需要 继承 Base0bservab1le， 也 不 用 提供 @Bindable 注 
解 ， 因 为 LiveData 有 自己 的 办 法 来 通知 观察 者 。 然 而 ， 正 如 你 在 第 11 


章 看 到 的 那样 ，LiveData 不 需要 Lifecycle0wner。 为 了 告诉 数据 绑 定 
框架 观察 title 属 性 时 要 使 用 哪个 LifecycleOwner， 你 需要 更 新 
SoundAdapter 类 ， 在 创建 绑 定 之 后 设置 Lifecycle0wner 属 性 : 


private inner class SoundAdapter(private val sounds: List<Sound>) : 
RecyclerView.Adapter<SoundHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): 
SoundHolder { 
val binding = DataBindingUtil.inflate<ListItemSoundBinding>( 
layoutInflater, 
R.layout.list item sound, 
parent, 
false 


) 
binding.lifecycleOwner = this@MainActivity 


return SoundHolder(binding) 


也 就 是 说 ， 把 MainActivity 设 置 为 LifecycleOwner。 这 样 ， 只 要 
title 属 性 没有 变化 ，MainActivity 视 图 就 不 会 变化 。 


第 20 5€ 首 频 播放 与 时 元 测试 


MVVM 架 构 极 大 方便 了 一 项 关键 编程 工作 ， 单 元 测试 。 这 也 是 其 受 欢 
迎 的 另 一 个 原因 。 单 元 测试 是 指 编写 小 程序 去 验证 主 应 用 各 个 单元 的 独 
立行 为 。BeatBox 应 用 的 单元 是 一 个 个 类 。 单 元 测试 就 是 测试 这 些 类 。 


BeatBox 的 音频 资源 文件 已 准备 就 纤 ， 本 章 将 学 习 如 何 播放 这 些 .wav 音 
频 文 件 。 在 创建 音频 播放 功能 并 整合 的 过 程 中 ， 还 会 对 
SoundViewMode1 的 功能 整合 做 单元 测试 。 


Android 的 大 部 分 音频 API 比 较 低 级 ， 不 易 掌 握 。 不 过 没关系 ， 对 于 
BeatBox 应 用 ， 可 以 使 用 SoundPoo1l 这 个 定制 版 实用 工具 。SoundPool 
能 加 载 一 批 声音 资源 到 内 存 中 ， 并 能 控制 同时 播放 的 音频 文件 的 个 数 。 
狂 按 各 个 按钮 播放 音频 ， 也 不 用 担心 会 摘 坏 应 用 或 
让 手机 


准备 好 了 吗 ? 开始 吧 。 


20.1 创建 SoundPool 


首先 要 实现 音频 播放 功能 ， 这 需要 创建 一 个 SoundPoo1 对 象 ， 如 代码 清 
单 20-1 所 示 。 


代码 清单 20-1 创建 soundPoo1 对 象 (BeatBox.kt) 


private const val TAG = "BeatBox" 
private const val SOUNDS FOLDER = "sample sounds" 
private const val MAX_SOUNDS = 5 


class BeatBox(private val assets: AssetManager) { 


val sounds: List<Sound> 

private val soundPool = SoundPool.Builder() 
.setMaxStreams(MAX SOUNDS) 
.build() 


init ( 


sounds = loadSounds() 


SoundPoo1l.Builder 可 以 创建 一 个 soundPoo1 实 


例 。setMaxSstreams(Int) 选 项 可 以 指定 某 个 时 刻 同 时 播放 多 少 个 音 
频 。 这 里 指定 了 五 个 。 已 经 播放 了 五 个 音频 时 ， 如 果 再 尝试 播放 第 6 
个 ，SoundPool 则 会 停止 播放 最 早 播 放 的 那个 首 频 。 


除了 setMaxStreams(Int) 选 项 ， 还 可 以 使 

用 setAudioAttributes(AudioAttributes) 指 定 其 他 不 同音 频 流 属 
性 。 有 具体 有 哪些 请 碍 看 开发 者 文档 。 不 过 ， 束 本 例 来 说 ， 使 用 默认 的 音 
频 流 属性 就 够 了 。 


20.2 访问 Assets 


之 前 ， 我 们 已 把 首 频 文件 保存 在 应 用 的 assets 里 。 访 问 并 播放 这 些 音 频 
文件 之 前 ， 先 来 讨论 一 下 assets 的 工作 原理 。 


Sound 对 象 有 一 个 asset 文 件 路 径 定 义 。 如 果 和 尝试 用 File 对 象 去 打开 它 
们 ，asset 文 件 路 径 则 无 效 。 正 确 的 做 法 是 使 用 AssetManager 对 象 。 


assetPath = sound.assetPath 


assetManager = context.assets 


soundData = assetManager.open(assetPath) 


这 样 ， 你 就 能 得 到 一 个 标准 的 InputSstream 数 据 流 。 然 后 ， 你 就 能 像 使 
用 Kotlin 里 其 他 InputSstream 一 样 用 它 了 。 


不 过 ， 有 些 API (比如 SoundPoo1) 需要 的 是 FileDescriptor。 如 果 
是 这 样 ， 那 么 你 可 以 转 而 调用 AssetManager.openFd(String): 


val assetPath = sound.assetPath 


val assetManager = context.assets 


// AssetFileDescriptors are different from FileDescriptors... 


val assetFileDescriptor = assetManager.openFd(assetPath) 


// ... but you can get a regular FileDescriptor easily if you need to 
val fileDescriptor = assetFileDescriptor.fileDescriptor 


20.3 ”加 载 首 频 文件 


接 下 来 就 是 使 用 SoundPool 加 载 音频 文件 。 相 比 其 他 音频 播放 方 

法 ，SoundPoo1 还 有 个 快速 啊 应 的 优势 : 指令 刚 一 发 出 ， 它 就 立即 开始 
播放 ， 一 点 儿 都 不 拖 坦 。 

不 过 反应 快 也 要 付出 代价 ， 那 就 是 在 播放 前 必须 预先 加 载 音 

频 。SoundPool 加 载 的 音频 文件 都 有 目 己 的 Integer 型 ID。 如 代码 清单 
20-2 所 示 ， 为 管理 这 些 ID， 在 Sound 类 中 添加 soundId 属 性 。 


代码 清单 20-2 添加 soundId 属 性 (Sound.kt) 


class Sound(val assetPath: String, var soundId: Int? = null) { 


val name = assetPath.split("/").last().removeSuffix (WAV) 
} 


注意 ，soundId 是 个 可 空 类 型 (Int?) 。 这 样 ， 在 Sound 的 soundId 没 
有 值 时 ， 可 以 设置 其 为 null 值 。 


现在 处 理 音频 加 载 。 在 BeatBox 中 添加 1]oad(Sound) 函 数 载 入 首 频 ， 如 
代码 清单 20-3 所 示 。 


代码 清单 20-3 加载 音频 (BeatBox.kt) 


class BeatBox(private val assets: AssetManager) { 


private fun loadSounds(): List<Sound> { 


} 


private fun load(sound: Sound) { 
val afd: AssetFileDescriptor = assets.openFd(sound.assetPath) 
val soundId = soundPool.load(afd, 1) 
sound.soundId = soundId 


Val HHsoundPool.load(AssetFileDescriptor, Int) MA, WL 
频 文件 载 入 SoundPool1 待 播 。 为 了 方便 管理 、 重 播 或 抒 载 音频 文 

件 ，soundPool.1oad(...) 录 数 会 返回 一 个 Int 型 ID。 这 实际 就 是 存储 
在 soundId 中 的 ID。 


注意 ， 调 用 openFd(String) 函 数 有 可 能 抛 出 IOException， 调 
用 load(Sound) 函 数 也 是 如 此 。 因 此 ， 只 要 调用 load(Sound)， 就 必须 
处 理 可 能 发 生 的 IOException 异 常 。 


现在 ， 在 BeatBox.1oadSounds() 函 数 中 ， 调 用 load(Sound) 函数 载 入 
全 部 音频 文件 ， 如 代码 清单 20-4 所 示 。 
代码 清单 20-4 载 入 全 部 音频 文件 《BeatBox.kt) 


private fun loadSounds(): List<Sound> { 


val sounds = mutableListOf<Sound>() 
soundNames.forEach { filename -> 
val assetPath = "$SOUNDS FOLDER/$filename" 
val sound = Sound(assetPath) 


— — seunds-add(seund) 


try { 
load(sound) 
sounds.add(sound) 
) catch (ioe: IOException) ( 
Log.e(TAG, "Cound not load sound $filename", ioe) 


) 
} 


return sounds 


运行 应 用 确认 音频 都 已 正确 加 载 。 否 则 ， 会 看 到 LogCat 中 的 红色 异常 日 
十 


Ù 


20.4 播放 音频 


最 后 一 步 是 播放 音频 。 在 BeatBox 中 添加 play(Sound) 函 数 ， 如 代码 清 


单 20-5 所 示 。 
代码 清单 20-5 ”播放 音频 (BeatBox.kt) 
class BeatBox(private val assets: AssetManager) { 
init { 


sounds = loadSounds() 


} 


fun play(sound: Sound) { 
sound.soundId?.let ( 
soundPool.play(it, 1.0f, 1.0f, 1, ©, 1.0f) 


播放 前 ， 要 检查 并 确保 soundId 不 是 nul1 值 。Sound 加 载 失 败 会 出 现 
null 值 的 情况 。 


检查 通过 后 ， 束 可 以 调用 SoundPool.play(Int, Float, Float, 
Int，Int，Float) 函 数 播 放 音 频 了 。 这 些 参 数 依 次 是 : 音频 ID、 左 音 
量 、 右 音量 、 优 先 级 《无 效 ) 、 是 否 循环 和 播放 速率 。 我 们 需要 最 大 音 
量 和 第 速 播放 ， 所 以 传 入 值 1.6。 是 人 否 循环 参数 传 入 98， 代表 不 循环 。 
(如 果 想 无 限 循环 ， 可 以 传 入 -1。 相 信 这 会 超级 讨 人 大 。) 


现在 ， 可 以 把 音频 播放 功能 整合 进 SoundViewModel 了。 不 过 ， 我 们 打 
算 先 做 单元 测试 再 整合 。 具 体 做 法 是 这 样 的 先 写 个 肯定 会 失败 的 单元 
测试 ， 然 后 整合 ， 让 单元 测试 成 功 通过 。 


20.5 测试 依赖 


要 编写 测试 代码 ， 首 先 需 要 添加 两 个 测试 工具 : Mockito 和 Hamcrest。 
Mockito 是 一 个 方便 创建 模拟 对 象 的 Java 框 架 。 有 了 模拟 对 象 ， 就 可 以 单 
独 测试 SoundViewModel， 不 用 担心 会 因 代 人 码 关 联 关 系 测 到 其 他 对 象 。 


Hamcrest 是 个 规则 匹配 器 工具 库 。 匹 配器 可 以 方便 地 在 代码 里 模拟 匹配 
和 条件。 如果 不 能 按 预 期 匹配 条 件 定 义 ， 测 试 就 通 不 过 。 这 可 以 验证 代码 
是 人 否 按 预 期 工作 。 


JUnit 库 里 已 经 自 带 Hamcrest。 而 且 ， 在 创建 项 目 时 ，Android Studio 已 经 
自动 添加 了 JUnit 依 赖 。 所 以 ， 我 们 只 需要 手动 添加 Mockito 依 赖 束 可 以 
了 。 打 开 应 用 模块 的 build.gradle 文 件 ， 添 加 Mockito 依 赖 ， 如 代码 清单 
20-6 所 示 。 添 加 完成 后 ， 记 得 同步 gradle 文 件 。 


代码 清单 20-6 添加 Mockito 依 赖 (app/build.gradle) 


dependencies { 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 


testImplementation 'org.mockito:mockito-core:2.25.0' 
testImplementation 'org.mockito:mockito-inline:2.25.0' 


} 


testImplementation 作 用 范围 表示 ， 这 两 个 依赖 项 只 包括 在 应 用 的 测 
试 编译 里 。 这 样 就 能 避免 在 APK 包 里 撒 带 上 无 用 代码 库 了 。 


你 用 来 创建 和 配置 模拟 对 象 的 函数 都 在 mockito-core 里 了 。 
而 mockito-inline 是 方便 Mockito 搭 配 Kotlin 使 用 的 特殊 依赖 。 


在 Kotlin 中 ， 所 有 的 类 都 是 final 的 。 也 就 是 说 ， 要 想 继承 这 些 类 ， 就 得 
用 上 open 修 饰 符 。 不 事 的 是 ，Mockito 主 要 靠 继承 来 模拟 测试 类 。 这 样 
一 来 ， 如 果 Mockito 想 模拟 Kotlin 类 ， 束 做 不 到 开 箱 即 用 了 。mockito- 
inline 依 赖 的 作用 就 是 绕 开 Kotlin 的 继承 限制 ， 不 用 修改 源 文件 ， 就 能 
让 Mockito 模 拟 Kotlin 的 那些 final 类 和 函数 。 


20.6 ”创建 测试 次 


写 单元 测试 最 方便 的 方式 是 使 用 测试 框架 。 测 试 框架 可 以 让 你 集中 编写 
和 运行 测试 案例 ， 并 且 能 在 Android Studio 里 看 到 测试 结果 。 


JUnit 是 最 常用 的 Android 单 元 测试 框架 ， 能 和 Android Studio 无 颖 整合 。 
要 用 它 测试 ， 首 先 要 创建 一 个 用 作 JUnit 测 试 的 测试 类 。 打 开 
SoundViewModel.kt 文 件 ， 使 用 Command+Shift+T 〈 或 Ctrl+Shift+T) 组 
合 键 。Android Studio 会 尝试 寻找 这 个 类 关联 的 测试 类 。 如 有 果 找 不 到 ， 它 
就 会 提示 新 建 ， 如 图 20-1 所 示 。 


class SoundViewModel : BaseObservable() { 
Choose Test for SoundViewModel (0 found) » 
var sound: Sound 
set (sound) {M TS PEP 


field = sound 
notifyChange() 


@get : Bindable 
val title: String? 
get() = sound?.name 


图 20-1 尝试 打开 测试 类 


选择 Create New Test... 创 建 一 个 新 测试 类 。 测 试 库 选择 JUnit4， 义 选 
setUp/@Before， 其 他 保持 默认 设置 ， 如 图 20-2 所 示 。 


( EOR ) Create Test 
Testing library: | JUnit4 v 
Class name: SoundViewModelTest 
Superclass: v 
Destination package: com.bignerdranch.android.beatbox v 
Generate: " setUp/GBefore 


[_] tearDown/@After 


Generate test methods for: (| | Show inherited methods 
Member 
[] ^* getSound():Sound 


g b setSound(sound:Sound):void 
[DD ^* getTitle():String 


3 = 

图 20-2 创建 测试 类 

点 击 OK 按钮 ， 进 入 下 一 个 对 话 框 。 

最 后 一 步 是 选择 创建 哪 种 测试 类 ， 或 者 说 选择 哪个 测试 目录 存放 测试 类 


CandroidTest 和 test) 。 在 androidTest 目 录 下 的 都 是 整合 测试 类 。 整 合 测 
试 可 以 运行 在 设备 或 虚拟 设备 上 上。 这样 做 有 优点 : 应 用 测试 所 在 的 运行 


环境 《系统 框架 和 API) 和 应 用 发 布 后 运行 在 设备 上 的 运行 环境 是 一 样 
的 。 但 也 有 缺点 : 设置 和 运行 比较 耗 时 ， 因 为 是 在 全 功能 版 本 的 
Android 系 统 上 运行 。 


在 test 目 录 下 的 是 单元 测试 类 。 单 元 测试 运行 在 JVM 上 ， 可 以 脱离 
Android 运 行 时 环境 ， 因 此 速度 会 快 很 多 。 


Android 平 侣 上 所 讲 的 “单元 测试 "这 一 术语 的 意义 已 超出 其 种 规 合 义 。 
有 了 时， 它 被 用 来 摘 述 单个 类 和 功能 单元 的 独立 测试 。 有 时 ， 残 是 指 test 
目录 下 的 任何 测试 。 然 而 ，test 目 录 下 茶 个 测试 看 似 是 验 证 单个 类 和 功 
能 单元 ， 但 实际 是 个 整合 测试 一 一 要 测试 应 用 茶 个 部 分 和 其 他 部 分 的 协 
同 工 作 。 有 关 整 合 测试 的 概念 和 讨论 ， 详 见 20.11 节 。 


这 里 提请 注意 ， 本 章 后 续 学 习 时 ， 说 到 JVM 测 试 ， 是 指 test 目 录 下 任何 
运行 在 JVM 上 的 测试 。 说 到 单元 测试 ， 是 指 单个 类 和 功能 单元 的 测试。 


单元 测试 的 规模 最 小 : 测试 单个 类 。 单 元 测试 不 需要 运行 整个 应 用 ， 也 
用 不 到 硬件 设备 。 它 们 可 以 不 影响 手头 工作 ， 快 速 反 复 地 执行 。 考 虑 到 
这 个 因素 ， 如 图 20-3 所 示 ， 我 们 选择 test 目 录 和 存放 测 试 类 ， 最 后 点 击 OK 
按钮 完成 。 


Qo Q9 Choose Destination Directory 
Directory Structure Choose By Neighbor Class 


Y 


app 
5 ...Japp/src/androidTest/java/com/bignerdranch/android/be: 


.../app/src/test/java/com/bignerdranch/android/beatbox 


Cancel 


图 20-3 ”选择 test 目 录 


20.7 ”配置 测试 类 


现在 来 配置 SoundViewModel 测 试 类 。Android Studio 已 经 为 我 们 创建 了 
一 个 名 为 SoundViewModelTest.kt 的 类 文件 (位 于 app 模 块 内 的 test 目 录 
F) 。 测 试 框架 创建 的 模板 类 只 有 一 个 setUp() 函 数 。 

class SoundViewModelTest { 


@Before 


fun setUp() { 
} 


对 大 多 数 对 象 来 说 ， 测 斌 就 是 要 创建 对 象 实例 及 其 依赖 的 其 他 对 象 。 为 
了 避免 为 每 一 个 测试 类 写 重 复 代码 ，JUnit 提 供 了 @Before 这 个 注解 。 以 
@Before 注 解 的 包含 公共 代码 的 函数 会 在 所 有 测试 之 前 运行 一 次 。 按 照 
约定 ， 所 有 单元 测试 类 都 要 有 一 个 以 @Before 注 解 的 setUp() 函数 。 


配置 测试 对 象 

在 setUp() 函 数 里 ， 我 们 会 创建 一 个 SoundViewMode1 实 例 用 来 测试 。 
这 需要 Sound 实 例 ， 因 为 SoundViewModel 需 要 Sound 对 象 才能 知道 如 何 
显示 按钮 标题 。 


首先 创建 一 个 SoundviewMode1 和 一 个 sound 对 象 Sound 是 个 简单 的 数 
据 对 象 ， 不 容易 出 问题 ， 这 里 就 不 模拟 它 了 ) ， 如 代码 清单 20-7 所 示 。 


代码 清单 20-7 创建 soundViewModel 测 试 对 象 
(SoundViewModelTest.java) 


class SoundViewModelTest { 


private lateinit var sound: Sound 
private lateinit var subject: SoundViewModel 


@Before 
fun setUp() { 


sound = Sound("assetPath") 
subject = SoundViewModel() 
subject.sound = sound 


} 


注意 ， 在 本 书 的 其 他 地 方 ， 声 明 SoundviewMode1 类 型 变量 时 ， 命 名 一 
般 是 soundViewModel。 这 里 用 subject 命 名 。 这 是 我 们 在 测试 时 的 一 
个 习惯 约定 ， 这 样 做 的 原因 有 两 点 : 


e 一 看 就 知道 ，subject 是 要 测试 的 对 象 “〈 与 其 他 对 象 区 别 开 来 ) ; 

e 如 果 SoundViewMode1 里 有 任何 函数 要 迁移 到 其 他 类 《比如 
BeatBoxSoundViewModel) 中 去 ， 那 么 测试 函数 可 以 直接 复制 过 
去 ， 省 了 soundViewModel 到 beatBoxSoundViewMode1l 重 命名 的 
麻烦 。 


20.8 ”编写 测试 函数 


setUp( ) 文 持 函 数 配 置 完成 了 ， 现 在 可 以 写 测试 代码 了 。 实 际 上 ， 写 测 
试 就 是 在 测试 类 里 写 一 个 以 @Test 注 解 的 测试 函数 。 


如 代码 清单 20-8 所 示 ， 首 先 写 一 个 函数 ， 上 断定 SoundViewMode1 里 的 
tit1le 属 性 和 Sound 里 的 name 属 性 是 有 关系 的 。 


代码 清单 20-8 测试 标题 属性 CSoundViewModelTest.kt ) 


class SoundViewModelTest { 


@Before 
fun setUp() { 


} 


@Test 
fun exposesSoundNameAsTitle() { 
assertThat(subject.title, is (sound.name) ) 


} 


注意 ， 窗 口 里 有 两 个 函数 会 变 红 : assertThat(...)flis(... 


Ey 
ES 
Ss 


在 assertThat(. ..) 函 数 上 使 用 Option+Return 〈 或 Alt+Enter) 组 合 
键 ， 然 后 选 org.junit 库 里 的 Assert.assertThat(...) 函 数 。 以 同样 方 
式 ， 为 is(...) 函 数 选 org.hamcrest 库 里 的 Is.is 函 数 。 


这 个 测试 使 用 了 Hamcrest 匹 配 堪 的 is(...) 函 数 和 JUnit 的 
assertThat(...) 函 数 。 函 数 体 里 的 代码 很 直 白 : 断定 测试 对 象 获取 
标题 函数 和 sound 的 获取 文件 名 函数 返回 相同 的 值 。 如 果 不 同 ， 单 元 测 
试 失败 。 


为 了 运行 测试 ， 右 键 单 击 SoundviewModelTest 类 名 ， 然 后 选择 Run 
'SoundViewModelTest'。 随 后 ，Android Studio 的 底部 窗口 会 显示 测试 结 
果 ， 如 图 20-4 所 示 。 
Run; © app — - SoundViewModelTest 
»0805:: (2 » Q Tests passed: 1 of 1 test- 15 04 ms 

©) SoundViewModelTest (com-bigr 1s 94ms "/ApplLications/Android Studio. app/Contents/ jre/jdk/Contents/Hone/bin/java" ... 


exposesSoundNameAsTitle 1s 94ms 
if Oe "process finished with exit code 0 


图 20-4 测试 过 关 
测试 结果 窗口 默认 只 会 显示 失败 的 测试 。 因 此 ， 测 试 通 过 了 。 


测试 对 象 交 互 


刚才 做 了 测试 热身 ， 现 在 处 理 关 键 任务 : 测试 soundviewMode1 和 
BeatBox.play(Sound) 的 交互 。 实 践 中 ， 通 常 的 做 法 是 ， 在 写 新 函数 
之 前 ， 先 写 一 个 测试 验证 这 个 函数 的 预期 结果 。 我 们 需要 
YESoundViewModelZS Hi S onButtonClicked() KUA i 

用 BeatBox.p1lay(Sound) 函 数 。 如 代码 清单 20-9 所 示 ， 写 一 个 测试 方 
法 调用 onButtonC1licked() 函 数 。 


代码 清单 20-9 测试 onButtonClicked() 函 数 
(SoundViewModelTest.kt ) 


class SoundViewModelTest { 


@Test 
fun exposesSoundNameAsTitle() { 
assertThat(subject.title, is (sound.name) ) 


} 


@Test 

fun callsBeatBoxPlayOnButtonClicked() { 
subject.onButtonClicked() 

} 


注意 ， 这 个 函数 还 没 写 ， 所 以 其 显示 与 其 他 函数 不 同 。 将 光标 移 到 它 身 
上 ， 按 Option+Return 〈 或 Alt+Enter) 组 合 键 ， 然 后 选 Create member 
function 'SoundViewModel.onButtonClicked' 创 建 这 个 函数 ， 如 代码 清单 
20-10 所 示 。 


代码 清单 20-10 ”创建 onButtonClicked() 函 数 
(SoundViewModel.kt) 


class SoundViewModel : BaseObservable() { 
fun onButtonClicked() { 
TODO("not implemented") //To change ... 


} 


IWKETODOIE®), Jui OX HEE eA AL, F4Command+Shift+T (或 
Ctrl-Shift-T) 组 合 键 ， 回 到 SoundVviewMode1lTest 测 试 类 。 


测试 会 调用 这 个 函数 ， 但 也 要 确认 它 按 预期 行事 : 调 
用 BeatBox.play(Sound)。 因 此 ， 第 一 步 要 做 的 就 是 提供 一 
个 BeatBox 对 象 给 SoundViewModel。 


你 可 以 在 测试 里 创建 一 个 BeatBox 对 象 ， 然 后 把 它 传 给 视图 模型 的 构造 
函数 。 但 是 这 样 做 会 带 来 一 个 问题 : 如 果 BeatBox 有 问题 ， 那 么 

在 SoundViewModel 里 使 用 BeatBox 的 测试 也 会 出 问题 。 事 与 愿 

违 ，SoundViewMode1 的 单元 测试 只 有 在 SoundViewMode1 有 问题 时 才 
会 失败 。 


换 句 话说 ， 我 们 只 想 测试 soundviewModel 的 行为 表现 。 至 于 它 和 其 他 
类 的 交互 应 该 隔离 开 来 。 这 才 是 单元 测试 的 关键 原则 。 


解决 办 法 是 使 用 模拟 BeatBox。 这 个 模拟 对 象 是 BeatBox 的 子 类 ， 有 和 
BeatBox 一 样 的 功能 ， 但 不 做 任何 事 。 这 样 一 来 ， 测 试 
SoundViewModel 时 ， 我 们 假定 它 能 正确 使 用 BeatBox。 


要 使 用 Mockito 创 建 模拟 对 象 ， 调 用 mock (Class ) 静 态 函 数 ， 传 入 要 模 
拟 的 类 就 可 以 了 。 如 代码 清单 20-11 所 示 ， 在 SoundViewModelTest 中 
创建 一 个 模拟 BeatBox， 以 及 一 个 保存 它 的 字段 。 


代码 清单 20-11 创建 模拟 BeatBox (SoundViewModelTest.kt ) 


class SoundViewModelTest 
private lateinit var beatBox: BeatBox 
private lateinit var sound: Sound 


private lateinit var subject: SoundViewModel 


@Before 


fun setUp() { 
beatBox = mock(BeatBox::class. java) 
sound = Sound("assetPath") 
subject = SoundViewModel() 
subject.sound = sound 


WLR S| FAAS — FE, mock(Class)r&Z t3 ERZA. XC BRL AAA 
创建 一 个 模拟 版 BeatBox。 


有 了 模拟 版 BeatBox， 就 可 以 用 单元 测试 验证 BeatBox.play(Sound ) 

函数 的 调用 了 。 这 种 烦 正 的 事 束 交 给 Mockito 吧 | 对 于 每 次 调用 ， 所 有 

的 Mockito 模 拟 对 象 都 能 自我 跟踪 管理 哪些 函数 被 调用 了 ， 以 及 都 传 入 

2 o Mockito 的 verify(Object) 函 数 可 以 确认 ， 要 测试 的 函数 
售 都 按 预 期 被 调用 了 。 


如 代码 清单 20-12 所 示 ， 调 用 verify(Object) 函 数 ， 确 认 
onButtonClicked()rPá ZH] f BeatBox. play (Sound) K Zi. 


代码 清单 20-12 ”验证 BeatBox.play(Sound) 函 数 是 否 被 调用 
(SoundViewModelTest.kt) 


class SoundViewModelTest { 
@Test 
fun callsBeatBoxPlayOnButtonClicked() { 
subject.onButtonClicked() 


verify(beatBox).play(sound) 


} 


verify(Object) EH Sito, AIS wre: 


beatBox.play(sound) 

调用 verify(beatBox) 函 数 就 是 说 : “我 要 验证 beatBox 对 象 的 某 个 函 
数 是 否 调用 了 。” 紧 跟 的 beatBox.play(sound) 函 数 是 说 :“ 验 证 这 个 
函数 是 这 样 调用 的 。 "EEE VE: “验证 以 sound 作 为 参数 ， 调 用 了 
beatBox 对 象 的 play(...) 函 数 。 


SoundViewModel.onButtonClicked() 是 个 空 函 数 ， 因 此 ， 什 么 也 没 
发 生 。 这 意味 着 测试 应 该 会 失败 。 因 为 是 先 写 测试 ， 所 以 这 不 是 问题 。 
如 果 测 试 不 失败 ， 那 说 明 什么 也 没 测 到 。 


运行 测试 看 结果 。 可 以 按 之 前 步骤 运行 测试 ， 
Control+R (zAShift-F100 快捷 键 重复 上 一 次 的 Run 命 令 。) 运行 结果 如 
图 20-5 所 示 。 


Rum © app — SoundViewModelTest 
POEuUE TE VEO (0 Tests failed: 1, passed: 1 of 2 tests - 961 ms 


on CCEA " /Applications /Android Studio, app/Contents/jre/jdk/Contents/Hone/bin/java” ... 


QexposesSoundNameAsTitle — 909ms 


())callsBeatBoxPlayOnButtonClicked 52ms 人 


beatBox, play( 
con, bignerdranch, android, beatbox, Sound@sfae7el2 
i 
-> at com.bignerdranch, android, beatbox, BeatBox, play (BeatBox, kt:25) 
Actually, there were zero interactions with this mock. 


mi Wanted but not invoked: 
beatBox, play( 
办 con, bignerdranch, android, beatbox. Sound@dfag7el2 


j 
-> at combignerdranch, android, beatbox, BeatBox, play (BeatBox, kt:25) 
Actually, there were zero interactions with this mock, 


120-5 ”测试 失败 输出 
测试 结果 表明 ， 测 试 方法 要 调用 beatBox.play(sound)， 但 没 成 功 : 


Wanted but not invoked: 
beatBox.play( 
com.bignerdranch.android.beatbox.Sound(23571b748 


....CallsBeatBoxPlayOnButtonClicked(SoundViewModelTest.java:28) 
Actually, there were zero interactions with this mock. 


这 实际 上 是 说 ， 和 assertThat(...) 函 数 一 样 ，verify(ObJject) 做 出 
某 个 断定 ， 但 断定 无 效 ， 测 试 失败 并 给 出 问题 原因 日 志 。 


现在 来 修正 测 斌 代码。 首先， 为 SoundViewMode1 创 建 一 个 接受 
BeatBox 实 例 的 构造 函数 属性 ， 如 代码 清单 20-13 所 示 。 


代码 清单 20-13 ”把 BeatBox 传 给 
SoundViewModel (SoundViewModel.kt) 


class SoundViewModel(private val beatBox: BeatBox) : BaseObservable() { 


= 


这 样 修改 ， 相 应 代码 会 有 两 处 错误 : 一 个 在 测试 代码 里 ， 一 个 在 生产 代 
码 里 。 先 来 修改 生产 代码 。 打 开 MainActivity.kt， 将 beatBox 对 象 提供 
给 视图 模型 ， 如 代码 清单 20-14 所 示 。 


代码 清单 20-14 修正 soundHolder 里 的 错误 CMainActivity.kt) 


private inner class SoundHolder(private val binding: ListItemSoundBinding) 
RecyclerView.ViewHolder(binding.root) { 


init { 
binding. viewModel = SoundViewModel(beatBox) 
} 


fun bind(sound: Sound) ( 


} 


接 下 来 ， 在 测试 类 里 ， 给 视图 模型 提供 模拟 版 BeatBox， 如 代码 清单 20- 
15 所 示 。 


代码 清单 20-15 在 测试 类 里 提供 模拟 
版 BeatBox (SoundViewModelTest.kt ) 


class SoundViewModelTest { 
@Before 
fun setUp() { 
beatBox = mock(BeatBox::class. java) 


sound = Sound("assetPath") 
subject = SoundViewModel (beatBox) 
subject.sound = sound 


离 测 试 目 标 越 来 越 近 了 ， 接 下 来 是 实现 onButtonClicked() 函 数 ， 让 
测试 符合 预期 ， 如 代码 清单 20-16 所 示 。 


代码 清单 20-16 ”实现 onButtonClicked() 函 数 
(SoundViewModel.kt) 


class SoundViewModel(private val beatBox: BeatBox) : BaseObservable() { 


fun onButtonClicked() { 
sound?.let { 
beatBox.play(it) 


再 次 运行 测试 。 如 图 20-6 所 示 ， 这 次 一 路 绿灯 ， 测 试 顺 利通 过 


Run; = app SoundViewModelTest 


OSLER- V  & Tests passed: 2 of 2 tests - 801 ms 
© SoundViewModelTest (com.bignerdra orms "/Apptications/Android Studio. app/Contents/jre/}dk/Contents/Home/bin/ java"... 


() exposesSoundNameAsTitle m: 4 "—— 
() calsBeatBoxPlayOnButtonClicked sins S Inished with exit cote 


图 20-6 测试 全 部 过 关 


20.9 ”数据 绑 定 回调 


应 事件 还 差 最 后 一 步 : 关联 按钮 对 象 和 onButtonClicked() 


和 前 面 使 用 数据 绑 定 关联 数据 和 UI 一 样 ， 你 也 可 以 使 用 lambda 表 人 达 式 ， 
让 数据 绑 定 帮忙 关联 按钮 和 点 击 监听 器 《如 果 生 了 了 ， 请 参见 19.9.1 
4S) 


如 代码 清单 20-17 所 示 ， 在 布局 文件 里 ， 添 加 数据 绑 定 lambda 表 达 式 ， 
让 按钮 对 象 科 SoundViewMode1l.onButtonClicked() 函 数 关 联 起 来 。 


代码 清单 20-17 关联 按钮 (list_item_sound.xml) 


<Button 
android: layout_width="match_parent" 
android: layout_height="12@dp" 


android: onClick="@{() -> viewModel.onButtonClicked()}" 
android: text="@{viewModel.title}" 
tools: text="Sound name"/> 


现在 ， 如 果 运 行 应 用 ， 按 钮 就 能 播放 声音 。 然 而 ， 如 果 你 尝试 使 用 锤子 
形 的 运行 按钮 ， 测 试 又 运行 了 。 这 是 因为 右键 单 击 运行 测试 修改 了 运行 
配置 。 这 个 配置 决定 点 击 锤子 形 的 按钮 之 后 ，Android Studio 该 运行 什 
Zo 


tlÉ20-7Przs. 7yf3i3efrBeatBox|V Hj, Mati (rie 27321) Bo Se FE 
器 ， 切 换 至 app 运 行 配 置 。 


€ S SoundViewModelTest ~ > i 6 i£ m wm 以 


testing base | 4 Edit Configurations... nerdranch andr 
H Save 'SoundViewModelTest' Configuration | 
3wModelTest.kt 


ViewModel.kt i 
<7xml version- NR 
<layout xmlns: beatbox in app 5/android" 
xmlns: E 
datas SoundViewModelTest 


<varia SoundViewModelTest (1) 
name-"viewModel" 
type-"com.bignerdranch.android.beatbox.SoundViewModel"/- 
«/data» 


图 20-7 切换 运行 配置 


运行 BeatBox 应 用 ， 扣 击 按钮 。 你 会 听 到 各 种 吓人 的 喊叫 声 。 不 要 害 
避 ， 前 面 说 过 ， 这 个 应 用 就 是 用 来 吓人 的 。 


20.10 释放 音频 


BeatBox 应 用 可 用 了 ， 但 别 忘 了 做 善后 工作 。 音 频 播放 完毕 ， 应 调 
用 SoundPool.release() 函 数 释放 SoundPool1， 如 代码 清单 20-18 所 
示 。 


代码 清单 20-18 ”释放 SoundPool (BeatBox.kt) 


class BeatBox(private val assets: AssetManager) { 


fun play(sound: Sound) { 


} 


fun release() { 
soundPool.release() 


} 


private fun loadSounds(): List<Sound> { 


} 


同样 ， 在 MainActivity 中 ， 也 完成 BeatBox 对 象 的 释放 ， 如 代码 清单 
20-19 所 示 。 


代码 清单 20-19 释放 BeatBox (MainActivity.kt) 
class MainActivity : AppCompatActivity() { 


private lateinit var beatBox: BeatBox 


override fun onCreate(savedInstanceState: Bundle?) { 


j 


override fun onDestroy() { 
super.onDestroy() 
beatBox.release() 


~ 


再 次 运行 应 用 ， 确 认 添 加 release() 函 数 后 ， 应 用 工作 正常 。 党 试播 放 


长 一 点 儿 的 声音 ， 然 后 旋转 设备 或 点 击 回 退 键 ， 声 音 播 放 应 该 会 停止。 


20.11 深入 学 习 : 整合 测试 


在 测试 SoundViewMode1 时 ， 我 们 创建 了 soundViewMode1lTest 单 元 测 
试 类 。 实 际 上 ， 我 们 也 可 以 选择 创建 整合 测试 。 那 么 ， 什 么 是 整合 测 
iw? 


在 单元 测试 里 ， 受 测 对 象 是 单个 类 。 在 整合 测试 里 ， 受 测 对 象 是 应 用 的 
一 部 分 ， 包 括 协同 工作 的 众多 对 象 。 这 两 种 测试 都 很 重要 ， 有 不 同 的 作 
用 和 目的 。 单 元 测试 保证 各 个 类 单元 正确 运行 ， 相 互 之 间 的 交互 符合 预 
期 。 整 合 测试 验证 受 测 各 部 分 已 正确 整合 在 一 起 ， 按 预期 发 挥 作用 。 


整合 测试 也 可 以 用 来 测试 应 用 的 非 UI 部 分 ， 如 测试 数据 库 交 互 等 。 不 

过 ， 在 Android 平 台 上 ， 整 合 测 试 通常 还 是 指 UI 级 别 的 测试 (和 UI 部 件 
交互 ， 验 证 它们 的 行为 表现 是 否 符合 预期 ) 。 例 如 ， 在 MainActivity 
启动 后 ， 可 以 验证 用 户 界面 上 的 第 一 个 按钮 显示 了 音频 库 里 的 第 一 个 文 
件 名 : 65_cjipie。 


针对 UI 的 整合 测试 需要 activity 和 fragment 这 样 的 框架 类 。 有 时 还 需要 系 
统 服务 、 文 件 系统 ， 以 及 一 些 JVM 测 试 无 法 使 用 的 功能 部 件 。 基 于 这 个 
原因 ， 在 Android 平 台 上 ， 整 合 测试 通常 以 instrumentation 测 试 来 实施 。 


相 比 应 用 按 设想 实现 出 来 ， 只 有 当 应 用 按 设想 正确 运行 时 ， 整 合 测试 才 
算 通 过 。 修 改 某 个 按钮 ID 的 名 字 并 不 会 影响 应 用 的 功能 。 但 是 ， 如 果 你 
写 了 这 样 一 个 整合 测试 用 例 , “调用 findViewById(R.id.button) 函 
数 ， 确 认 找 到 的 按钮 上 的 文字 显示 正确 ”， 那 么 显然 这 个 测试 通 不 过 。 
所 以 ， 整 合 测试 应 该 用 UI 测试 框架 工具 来 写 ， 而 不 是 使 用 像 
findViewById(Int) 这 样 的 标准 库 工具 。 这 样 可 以 很 容易 写 出 类 似 这 
样 的 用 例 :“ 确 保 屏 幕 上 有 个 按钮 ， 上 面 显示 我 设想 的 文字 。” 


Espresso 是 Google 开 发 的 一 个 UI 测试 框架 ， 可 用 来 测试 Android 应 用 。 在 
app/build.gradle 文 件 中 ， 添 加 com.android.support.test.espresso:espresso- 
core 依 赖 项 ， 作 用 范围 改 为 androidTestImplementation， 就 可 以 引 
入 它 。 不 过 ，Android Studio 在 创建 新 项 目 时 ， 会 自动 引入 这 个 依赖 。 


引入 Espresso 之 后 ， 就 可 以 用 它 来 测试 某 个 activity 的 行为 了 。 例 如 ， 如 


果 想 断定 屏幕 上 某 个 视图 显示 了 第 一 个 sample_sounds 受 测 文 件 的 文件 
名 ， 就 可 以 编写 如 下 测试 用 例 : 


@RunWith(AndroidJUnit4: :class) 
class MainActivityTest { 


@get:Rule 
val activityRule = ActivityTestRule(MainActivity: :class. java) 


@Test 
fun showsFirstFileName() { 
onView(withText("65 cjipie")) 
.check(matches(isDisplayed())) 


现在 来 解读 一 下 样 例 代码 。 首 先 看 其 中 的 注解 。 
@RunWith(AndroidJUnit4.class) 表 明 ， 这 是 一 个 Android 工 具 测 试 ， 需 要 
activity 和 其 他 Android 运 行 时 环境 文 持 。 之 后 ，activityRule 上 的 
@getRule 注 解 告诉 JUnit， 运 行 测试 前 ， 要 局 动 一 个 MainActivity 实 
例 。 


准备 工作 做 完 ， 接 下 来 就 可 以 在 测试 函数 里 对 MainActivity 做 断定 测 
iS. fEshowsFirstFileName( ) K% 
里 ，onView(withText("65_cjipie")) 这 行 代码 会 找到 显 

示 “65_cjipie” 的 视图 ， 对 其 执行 测 
R, check(matches(isDisplayed())) 用 来 判定 视图 在 屏幕 上 看 得 
见 。 如 果 没 有 ， 则 测试 失败 。 相 较 于 JUnit 的 assertThat(...) 上 断言 函 
数 ，check(...) 函 数 是 Espresso 版 的 断言 函数 。 


有 了 时， 你 可 能 还 想 点 击 某 个 视图 ， 然 后 使 用 断言 验证 点 击 结 果 。 可 以 让 
Espresso 点 击 这 个 视图 ， 或 者 使 用 下 面 这 样 的 交互 代码 : 


onView(withText("65 cjipie")) 


.perform(click()) 


与 视图 交互 时 ， ，Espresso 会 等 待 应 用 朵 置 再 执行 下 一 个 测试 。Espresso 有 
一 套 探 测 UI 是 否 已 更 新 完毕 的 方法 。 如 果 需 要 ， 也 可 使 用 一 
个 IdlingResource 子 类 告诉 Espresso: 多 等 一 会 儿 ， 应 用 还 在 忙 。 


有 关 如 何 使 用 Espresso 做 UI 测试 的 更 详细 的 信息 ， 请 阅读 Espresso 的 文 
档 。 


单元 测试 和 整合 测试 作用 不 同 ， 各 有 侧重 。 大 多 数 人 更 喜欢 先 做 单元 测 
试 ， 直 接 验证 应 用 单独 部 分 的 运行 行为 和 表现 。 整 合 测试 依赖 于 那些 受 
测 通过 的 单独 部 分 ， 验 证 它们 是 否 已 正确 整合 ， 并 一 起 协同 工作 且 运 行 
民 好 。 不 管 怎样 ， 这 两 类 测试 都 很 重要 ， 各 目 能 从 不 同 视 角 检 验 应 用 。 
只 要 有 条 件 ， 两 类 测试 都 要 做 。 


20.12 深入 学 习 : 模拟 对 象 与 测试 


相 比 单元 测试 ， 模 拟 对 象 在 整合 测试 中 扮演 了 更 为 不 寻常 的 角色 。 模 拟 
对 象 假扮 成 其 他 不 相干 的 组 件 ， 其 作用 就 是 隔离 受训 对 象 。 单 元 测试 的 
受 测 对 象 是 单个 类 ; 每 个 类 部 有 自己 不 同 的 依赖 关系 ， 所 以 ， 每 个 受 测 
类 也 有 一 套 不 同 于 其 他 类 的 模拟 对 象 。 既 然 都 是 些 不 同 的 模拟 对 象 ， 那 
么 它们 各 自 的 具体 行为 怎么 样 ， 怎 么 实现 ， 一 点 儿 也 不 重要 。 对 于 单元 
人 
非常 有 用 了 。 


再 来 看 整合 测试 。 在 整合 测试 场景 中 ， 模 拟 对 象 显 然 不 能 用 来 隔离 应 
用 ， 相 反 ， 我 们 用 它 把 应 用 和 可 能 的 外 部 交互 对 象 隔离 开 来 ， 比 如 提供 
Web service 假 数据 和 假 反 馈 。 如 果 是 在 BeatBox 应 用 里 ， 你 很 可 能 就 要 
提供 模拟 SoundPoo1， 让 和 它 告 诉 你 某 个 声音 文件 何 时 播放 。 显 然 ， 相 比 
和 常见 的 行为 模拟 ， 这 种 模拟 太 重 了 ， 而 且 还 要 在 很 多 整合 测试 里 共享 。 
这 真 不 如 手动 写 假 对 象 。 所 以 ， 做 整合 测试 时 ， 最 好 避免 使 用 像 
Mockito 这 样 的 自动 模拟 测试 框架 。 


不 管 哪 种 情况 ， 基 本 原则 都 一 样 : 模拟 对 象 的 效用 不 应 超出 受 测 组 件 的 
Uio MEERE, EMAR. A, WRZ 
RR, MRA AWW T. 


20.13 ”挑战 练习 : 播放 进度 控制 


让 用 户 快速 多 听 一 些 声 音 ， 请 给 BeatBox 应 用 添加 播放 进度 控制 功能 。 
完成 后 的 界面 如 图 20-8 所 示 。 在 MainActivity 中 ， 使 用 SeekBar 部 件 
fs 1illSoundPoolfplay(Int, Float, Float, Int, Int, Float) Pr 


数 的 播放 速率 参数 值 。 


9:00 | 
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20.14 ”挑战 练习 : 设备 旋转 问题 


当前 ， 播 放声 音 后 ， 设 备 一 旋转 ，BeatBox 应 用 就 停止 播放 音频 了 。 请 
修正 这 个 问题 。 

一 个 主要 问题 是 ，BeatBox 对 象 应 该 保存 在 哪里 。 应 用 的 
MainActivity 引 用 痢 BeatBox 对 象 ， 但 设备 旋转 后 ， 它 会 被 销毁 和 重 
建 。 结 果 ， 初 始 BeatBox 会 释放 SoundPoo1， 再 随 设备 旋转 重建 。 


在 GeoQuiz 和 CriminalIntent 应 用 中 ， 我 们 已 经 知道 如 何在 设备 旋转 时 保 


存 数 据 。 添 加 一 个 Jetpack 版 ViewMode1 给 BeatBox 应 用 ， 实 现在 设备 旋 
转 时 保存 BeatBox 对 象 。 


你 可 以 把 BeatBox 属 性 的 可 见 性 改 为 public， 这 样 ，MainActivity 就 能 
etpack 上 乒 ViewMode1 里 获取 BeatBox 实 例 ， 把 它 交 给 数据 绑 定 视图 模 
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Be 样式 与 主题 
人 
当前 ，BeatBox 应 用 依然 还 是 一 副 Android 千 年 不 变 的 老 面 孔 。 按 钮 普 
通 ， 配 色 灰 暗 。 整 个 应 用 看 上 去 毫 不 起 眼 ， 没 有 品牌 特色 。 

不 过 ， 我 们 能 让 它 风 格 大 变 。 我 们 具有 这 样 的 能 


应 用 界面 重 定制 的 最 终 效果 如 图 21-1 所 示 。 与 之 前 相 比 ， 新 界面 更 加 美 
观 、 引 人 注目 ， 且 独 具 风 格 。 
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图 21-1 换 了 主题 的 BeatBox 


21.1 HCAW 
首先 ， 我 们 来 定义 本 章 要 用 到 的 颜色 资源 。 参 照 代码 清单 21-1， 编 辑 


res/values/colors.xml 文 件 。 


代码 清单 21-1 定义 几 种 颜色 (res/values/colors.xml) 


<resources> 
«color name="colorPrimary" >#008577</color> 
«color name="colorPrimaryDark" >#@0574B</color> 
«color name="colorAccent">#D81B60</color> 


«color name="red">#F44336</color> 

<color name="dark_red">#C3352B</color> 

«color name="gray">#607D8B</color> 

«color name-"soothing blue">#0083BF</color> 

«color name-"dark blue"»1005A8A«/color» 
</resources> 


使 用 颜色 资源 ， 可 以 方便 地 在 一 个 地 方 定 义 各 种 颜色 值 ， 然 后 在 整个 应 
用 里 引用 。 


21.2 ”样式 
` 现 在 ， 我 们 来 给 按钮 添加 样式 。 样 式 是 能 够 应 用 于 视图 部 件 的 一 套 属 


o 


打开 res/values/styles.xml 样 式 文件 ， 添 加 一 个 名 为 BeatBoxButton 的 新 样 
式 ， 如 代码 清单 21-2 所 示 。 【创建 BeatBox 项 目 时 ， 癌 导 会 创建 默认 的 
styles.xml 文 件 。 如 果 没 有 ， 请 自行 创建 。) 


代码 清单 21-2 添加 样式 (res/values/styles.xml) 


<resources> 


<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<!-- Customize your theme here. --> 
«item name="colorPrimary">@color/colorPrimary</item> 


<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


<style name="BeatBoxButton"> 


«item name="android: background" >@color/dark_blue</item> 
</style> 


</resources> 


新 建 样式 名 为 BeatBoxButton。 该 样式 仅 定 义 了 android:background 
这 一 个 属性 ， 属 性 值 为 深蓝 色 。 样 式 可 以 为 很 多 部 件 共用 ， 更 改 属性 
时 ， 只 修改 公共 样式 定义 即 可 。 


定义 好 样式 ， 把 它 添 加 给 按钮 ， 如 代码 清单 21-3 所 示 。 
代码 清单 21-3 ”使 用 样式 (res/layout/list_item_sound.xml ) 


<Button 
style-"Qstyle/BeatBoxButton" 
android: layout_width="match_parent" 
android: layout_height="12@dp" 


android: onClick="@{() -> viewModel.onButtonClicked()}" 
android: text="@{viewModel.title}" 
tools: text="Sound name"/> 


运行 BeatBox 应 用 。 可 以 看 到 ， 所 有 按钮 的 背景 都 是 深蓝 色 了 ， 如 图 21- 
2 所 示 。 
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BeatBox 


图 21-2 添加 了 样式 的 按钮 

如 有 需要 ， 可 以 创建 带 多 套 属 性 的 样式 在 应 用 里 复 用 。 非 常 方便 。 
样式 继承 

样式 也 支持 继承 。 一 个 样式 能 继承 并 履 盖 其 他 样式 的 属性 。 

创建 一 个 名 为 BeatBoxButton .Strong 的 新 样式 。 除 了 继 

承 BeatBoxButton 样 式 的 按钮 背景 属性 ， 再 添加 自己 的 
android:textSstyle 属 性 ， 用 粗 体 显示 按钮 文字 ， 如 代码 清单 21-4 所 
示 。 


代码 清单 21-4 ”继承 样式 Cres/layout/styles.xml) 


<style name="BeatBoxButton"> 
«item name="android: background" >@color/dark_blue</item> 
</style> 


«style name-"BeatBoxButton.Strong"» 
«item name-"android:textStyle"»bold«/item» 
«/style» 


(当然 ， 可 以 直接 为 BeatBoxButton 样 式 添加 这 
个 android:textSstyle 属 性 。 创 建 BeatBoxButton.Strong 样 式 只 是 
为 了 演示 样式 继承 。) 


新 样式 的 命名 有 点 特别 。BeatBoxButton.Strong 的 命名 表明 ， 这 个 新 
样式 继承 了 BeatBoxButton 样 式 的 属性 。 


除了 通过 命名 表示 样式 继承 关系 ， 也 可 以 采用 指定 父 样式 的 方式 : 


<style name="BeatBoxButton"> 
«item name="android: background" >@color/dark_blue</item> 
</style> 


«style name-"StrongBeatBoxButton" parent="@style/BeatBoxButton"> 
«item name-"android:textStyle"»bold«/item» 
«/style» 


虽然 有 新 方式 用 于 继承 样式 ， BeatBox 应 用 还 是 继续 使 用 特殊 命名 方 


Ae 


更 新 res/layout/list_item_sound.xml 布 局 ， 用 上 新 的 粗 体 文字 样式 ， 如 代 
码 清单 21-5 所 示 。 


代码 清单 21-5 ”使 用 粗 体 文字 样式 


(res/layout/list_item_sound.xml ) 


<Button 
style="@style/BeatBoxButton. Strong" 
android: layout_width="match_parent" 


android: layout_height="120dp" 

android: onClick="@{() -> viewModel.onButtonClicked()}" 
android: text="@{viewModel.title}" 

tools: text="Sound name"/> 


运行 应 用 ， 确 认 按 钮 文字 已 显示 为 粗 体 ， 如 图 21-3 所 示 。 
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BeatBox 


图 21-3 ”使 用 了 粗 体 文字 样式 的 BeatBox 


21.3 主题 


样式 很 有 用 。 在 styles.xml 公 共 文 件 中 ， 可 以 为 所 有 部 件 定义 一 套 样式 属 
性 共用 。 可 惜 ， 定 义 公 共 样 式 属性 虽 方 便 ， 实 际 应 用 却 很 麻烦 : 需要 逐 
个 为 所 有 部 件 添 加 它们 要 用 到 的 样式 。 要 是 开发 一 个 复杂 应 用 ， 涉 及 很 
多 布局 、 无 数 按钮 ， 仪 仅 添加 样式 工作 量 就 很 怀 人 。 


该 主题 上 场 施 展 喘 手 了 ! 主题 可 修 看 作 样 式 的 进化 加 强 版 。 同 样 是 定义 
一 套 公 共 主 题 属性 ， 样 式 属性 需要 逐个 添加 ， 主 题 属性 则 会 自动 应 用 于 
整个 应 用 。 主 题 属性 能 引用 颜色 这 样 的 外 部 资源 ， 也 能 引用 其 他 样式 。 


使 用 主题 ， 无 须 找 到 每 个 按钮 ， 告 诉 它 们 要 用 哪个 主题 。 一 句 话 就 能 搞 
定 :“ 所 有 按钮 都 使 用 这 个 样式 。” 


修改 默认 主题 
创建 BeatBox 项 目 时 ， 回 导 给 了 它 默认 主题 。 找 到 并 打开 


manifests/AndroidManifest.xml 文 件 ， 可 以 看 到 application 标 签 下 的 
theme 属 性 。 


«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package-"com.bignerdranch.android.beatbox" > 


<application 
android: allowBackup="true" 
android: icon="@mipmap/ic_launcher" 
android: label="@string/app_name" 
android: roundIcon="@mipmap/ic_launcher_round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme" > 


</application> 


</manifest> 


theme 属 性 指向 的 主题 叫 AppTheme。 它 也 定义 在 styles.xml 文 件 中 。 


可 见 ， 主 题 实 际 就 是 一 种 样式 ， 但 是 其 指定 的 属性 有 别 于 样式 。《〈 稍 后 
会 看 到 。) 既然 能 在 manifest 文 件 中 声明 它 ， 那 么 主题 威力 就 会 大 增 。 
这 同时 解释 了 为 什么 主题 可 以 目 动 应 用 于 整个 应 用 。 


要 查看 AppTheme 主 题 定义 ， 只 要 按 住 Command 键 (Windows 系 统 是 Ctrl 
t) ， 点 击 @style/AppTheme，Android Studio 就 会 自动 打开 
res/values/styles.xml 文 件 。 


<resources> 


<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
</style> 
<style name="BeatBoxButton"> 

«item name="android: background" >@color/dark_blue</item> 


</style> 
</resources> 


YE Android Studio 中 创建 新 项 tH 时 ， 你 勾 选 了 Use AndroidX artifacts, Ji 
目 因 此 会 自 带 AppCompat 主 题 。AppTheme 现 在 继承 了 
Theme.AppCompat.Light. DarkActionBar 的 全 部 属性 。 如 有 需要 ， 
可 以 添加 自己 的 属性 值 ， 或 是 窗 新 父 主题 的 某 些 属性 值 。 


AppCompat 库 自 带 三 大 主题 。 


。Theme .AppCompat 一 一 深 色 主题 。 

。Theme.AppCompat.Light 一 一 浅 色 主题 。 

。Theme.AppCompat.Light.DarkActionBar 一 一 带 深 色 工 具 栏 的 
浅 色 主题 。 


E AppCompat， 如 代码 清单 21-6 所 
示 。 这 样 BeatBox 项 目 就 有 了 一 个 深 色 主题 基板 。 


代码 清单 21-6” 改 用 深 色 主题 (res/values/styles.xml) 


<resources> 


«style name="AppTheme" parent="Theme.AppCompat 


</style> 


</resources> 


JBeatBox 应 用 ， 查 看 新 的 深 色 主题 ， 如 图 21-4 所 示 。 
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图 21-4 应 用 了 深 色 主题 的 BeatBox 


21.4 ”添加 主题 闫 色 
现在 ， 基 于 AppTheme 主 题 模 板 ， 我 们 来 定制 它 的 属性 。 
在 styles.xml 文 件 中 ， 参 照 代码 清单 21-7 修 改 现 有 三 个 属性 。 


代码 清单 21-7 上 自 定义 主题 属性 (res/values/styles.xml) 


<style name="AppTheme" parent="Theme.AppCompat"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/ 


——eeterPrimnary 


——red«/item» 
«item name="colorPrimaryDark">@color/ 


——dark red«/item» 
«item name="colorAccent">@color/ 


— —colerAccent 
——gray«/item» 
</style> 


虽然 这 三 个 主题 属性 看 上 去 和 前 面 的 样式 属性 差不多 ， 但 它们 的 应 用 范 
围 不 一 样 。 样 式 属 性 仅 适用 于 单个 部 件 ， 如 前 面 用 粗 体 显示 按钮 文字 的 
textSstyle。 主 题 属性 则 适用 所 有 使 用 同一 主题 的 部 件 。 例 如 ， 应 用 栏 
会 以 主题 的 colorPrimary 属 性 设置 自己 的 背景 色 。 


使 用 这 三 个 主题 属性 ， 应 用 界面 大 有 改观 。colorPrimary 属 性 主要 用 
于 应 用 栏 。 由 于 应 用 名 称 是 显示 在 应 用 栏 上 的 ， 因 此 colorPrimary 也 
可 以 称 为 应 用 品牌 色 。 


colorPrimaryDark 用 于 屏幕 顶部 的 状态 栏 。 从 名 字 可 以 看 出 ， 它 是 深 
色 版 colorPrimary。 注 意 ， 只 有 Lollipop 以 后 的 系统 支持 状态 栏 主题 
色 。 对 于 之 前 的 系统 ， 无 论 指 定 什么 主题 色 ， 状 态 栏 都 是 不 变 的 黑 底 
色 。 图 21-5 展 示 了 这 两 种 主题 色 的 应 用 效果 。 


状态 栏 ，colorPrimaryDark 一 
soci 应 用 栏 ， colorPrimary 
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图 21-5“” 带 AppCompat 颜 色 属 性 的 BeatBox 


最 后 ， 设 置 colorAccent 为 灰色 。 这 个 主题 色 应 该 和 colorPrimary 形 
成 反差 效果 ， 主 要 用 于 给 EditText 这 样 的 部 件 着 色 。 


按钮 部 件 不 支持 着 色 ，colorAccent 主 题 色 在 BeatBox 项 目 中 没有 效 
果 。 不 管 有 没有 用 ， 这 里 还 是 添加 了 colorAccent， 因 为 最 好 能 配套 使 
用 这 三 个 颜色 属性 。 现 在 ， 刚 设置 的 主题 色 融 合 得 很 好 《继承 自 父 主题 
的 默认 colorAccent 可 能 会 和 你 指定 的 其 他 两 种 主题 色 冲 突 ) ， 算 是 给 进 
一 步 优 化 打下 了 良好 基础 。 


运行 应 用 查看 主题 效果 。 现 在 ， 应 用 界面 看 起 来 应 该 与 图 21-5 差 不 多 。 


21.5 mt mt 


完成 了 主题 配色 ， 我 们 继续 深入 ， 看 看 都 有 哪些 主题 属性 可 以 履 盖 。 给 
Ute NiE, FAITE IK, APA ABA REE. AEE EUR TE n] 
用 、 哪 些 能 覆盖 ， 甚 至 是 某 些 属 性 完 竟 有 什么 作用 ， 研 完 诸 如 此 类 的 问 
题 时 ， 没 有 官方 参考 文档 还 是 小 事 ， 极 有 可 能 你 就 完全 没 了 方向 。 对 
此 ， 我 们 只 有 一 个 建议 : 阅读 本 书 。 


第 一 个 任务 是 修改 主题 以 更 换 BeatBox 应 用 的 背景 色 。 当 然 ， 你 可 以 打 
开 res/layout/activity_main 文 件 ， 手 动 设置 RecyclerView 视 图 的 
android:background 属 性 。 如 果 还 有 其 他 fragment 和 activity 要 改 ， 都 
照 此 处 理 。 这 简直 是 浪费 : 浪费 你 的 时 间 ， 浪 费 应 用 资源 。 


主题 已 经 设置 了 背景 色 ， 在 此 基础 上 再 设置 其 他 颜色 ， 就 是 自 找 麻 烦 
了 。 而 且 ， 在 应 用 里 到 处 复制 使 用 背景 属性 设置 代码 也 不 利于 后 期 维 
IFs 

BARERA, Mae me Ee RETE. 7J TERE ee EY 
名 字 ， 先 来 看 看 这 个 目标 属性 在 其 Theme .AppCompat 父 主题 里 是 怎 
设置 的 。 

你 可 能 会 想 : “不 知道 名 字 ， 我 如 何 知道 该 覆盖 哪个 属性 呢 ? ”确实 是 这 


$. MA, ANAA HAREKET. AAHAS, BE, Ama 
行 应 用 验证 猜想 。 


你 需要 找 出 主题 继承 的 源头 。 主 题 继 承 树 有 多 深 ， 谁 也 不 知道 ， 只 能 一 
层 层 地 向 上 找 ， 直 到 找到 目标 为 止 。 


打开 styles.xml 文 件 ， 按 住 Command 键 (Windows 系 统 是 Ctrl 键 ) 点 击 
Theme .AppCompat， 来 看 看 继承 有 多 深 。 


(如果 无 法 直接 在 Android Studio 里 退 调 主题 属性 ， 或 是 想 在 工具 之 外 碍 
找 ， 可 以 在 your-SDK-directory/platforms/android-24/data/res/values 目 录 找 
到 主题 源码 。) 


Android 开 发 工具 更 新 频 索 ， 本 书 撰写 时 ，Android Studio 会 定位 到 一 个 
大 文件 的 这 一 行 : 


«style name="Theme.AppCompat" parent="Base.Theme.AppCompat" /> 


由 此 可 知 Theme.AppCompat 主 题 属 性 继承 自 
Base.Theme.AppCompat. AHA, Theme.AppCompatA Fit 28 
mE, MMB SRE. 


按 住 Command 键 (Windows 系 统 是 Ctrl 键 ) 点击 
Base.Theme.AppCompat, Android Studio 会 提示 ， 这 个 主题 有 资源 修饰 
符 ， 有 多 个 版 本 可 选 〈 取 诀 于 Android 系 统 版 本 ) 。 


选择 values/values.xml 版 本 ， 定 位 到 Base.Theme.AppCompat 主 题 定 义 ， 
如 图 21-6 所 示 。 


</style> 

«style nane="Theme AppConpat" parent="Base, Theme, AppConpat"/> 

<style nane="Thene.AppConpat CompactMenu" par Choose Declaration 
«style names" Thene, AppConpat Daylight" parent 
«style nanee"Thene,AppConpat Daylight, Dark Gradle: androidx,appconpat rappconpat 1. 0, 2¢aar 1 
«style nane="Thene,AppConpat Daylight, Dialog" Base. Theme, AppConpat (ss./Values-v21/values-v21.xNl) — Gradle: androidx.appconpat:appcompat: 1,0, 2@aar i 
«style name="Thene AppConpat .DayNight Dialog, Base. Theme. AppConpat (.../values-V22/values-v22. xml) — Gradle: android, appconpat:appconpat: 1, 0, 26987 Mi 
«style name="Theme AppConpat ,DayNight Dialog, $ » "MEME A PU a 
<style nane="Thene, AppConpat Daylight, Dialog Base, Theme, AppConpat. (.,./Values-v23/values-v23,xml) — Gradle: android, appconpat rappconpat:1. 0, 26887 fij 
<style name=" Theme, AppCompat ,DayNight NoActio Base, Theme, AppConpat (.../values-v26/values-v26,xml) — Grade: androddx.appcompatsappcompats 1,0, 2¢aar M 
<style name="Thene,AppConpat Dialog" parents" Base, Theme, AppConpat (.../values=v28/values-v28,xMl) — Grade: androidx.appconpatsappconpat 1.0. 2@aar f 
<style name="Theme AppConpat Dialog. Alert" parents"sase, Inene, AppLoMpat V1atog.ALert"/> 

<style nane=""Thene AppConpat Dialog. MinWidth" parent="Base, Theme, AppConpat Dialog, Minidth"/> 


Base, Thene.AppCompat (.../values/values. xml) 


图 21-6 ”选择 父 主题 


既然 BeatBox 支 持 的 最 低 API 级 别 是 21， 那 么 这 里 还 选择 无 修饰 版 本 似乎 
不 合 逻 辑 。 背 景 主题 属 性 早 在 API 21 之 前 就 有 了 ， 这 说 明 在 原始 

Base . Theme .AppCompat 版 本 中 肯定 也 能 找到 它 。 这 并 不 奇怪 ， 我 们 束 
是 要 选 无 修饰 版 Base.Theme.AppCompat。 


«style name="Base.Theme.AppCompat" parent="Base.V7.Theme.AppCompat"> 


</style> 


Base. Theme .AppCompatix AE WU EA AINE MM, AE A m 
任何 属性 。 继 续 定 位 到 它 的 父 主题 : Base.V7.Theme.AppCompat。 


«style name-"Base.V7.Theme.AppCompat" parent="Platform.AppCompat"> 
«item name-"viewInflaterClass"» 
androidx.appcompat.app.AppCompatViewInflater«/item» 
«item name-"windowNoTitle"»false«/item» 
«item name-"windowActionBar"»true«/item» 
«item name-"windowActionBarOverlay"»false«/item» 


«/style» 


距离 目标 越 来 越 近 了 。Base.V7.Theme.AppCompat 有 许多 属性 ， 但 还 
是 没 找到 改变 背景 色 的 属性 。 继 续 定位 到 Platform.AppCompat。 这 个 
主题 也 有 多 个 版 本 ， 选 择 values/values.xml 版 本 。 


«style name-"Platform.AppCompat" parent="android:Theme.Holo"> 
«item name="android:windowNoTitle">true</item> 
«item name="android:windowActionBar">false</item> 


«item name-"android:buttonBarStyle"»?attr/buttonBarStyle«/item» 
«item name-"android:buttonBarButtonStyle"»?attr/buttonBarButtonStyle«/i 
«item name-"android:borderlessButtonStyle"»?attr/borderlessButtonStyle« 


«/style» 


终于 ， 在 这 里 看 到 了 Platform.AppCompat 的 android:Theme .Holo 父 
主题 。 注 意 ， 这 里 引用 的 不 是 Theme， 而 是 android:Theme。 前 面 的 
android 命 名 空间 不 能 于。 


AppCompat 库 可 以 被 看 作 BeatBox 应 用 的 一 部 分 。 编 译 项 目 时 ， 工 具 会 


引入 AppCompat 库 和 它 的 一 堆 Kotlin (Java) 以 及 XML 文件 。 这 些 文件 
已 包含 在 应 用 里 ， 如 同 你 上 自己 编写 的 文件 。 如 果 想 引用 AppCompat 库 里 
的 资源 ， 像 Theme .AppCompat 这 样 ， 直 接 引 用 就 可 以 了 。 


有 些 主题 (比如 Theme) 包含 在 Android 操 作 系 统 里 ， 引 用 时 必须 加 上 指 
回归 属地 的 命名 空间 。 在 引用 Theme 主 题 时 ，AppCompat 库 使 用 了 
android:Theme 这 样 的 形式 ， 这 是 因为 Theme 来 自 Android 操 作 系 统 。 


总 算 找 到 了 。 在 这 里 ， 终 于 可 以 看 到 所 有 可 以 履 盖 的 主题 属性 。 当 然 ， 
还 可 以 继续 定位 到 Platform.AppCompat 的 父 主题 Theme.Holo， 不 过 
没 这 个 必要 。 我 们 想 要 的 属性 已 经 找到 了 。 


查看 代码 ， 可 以 看 到 windowBackground 这 个 属性 。 顾 名 思 义 ， 这 就 是 
用 于 主题 背景 色 的 属性 。 


«style name-"Platform.AppCompat" parent="android: Theme.Holo"> 


<!-- Window colors --> 


«item name="android:windowBackground">@color/background_material_dark</ 


这 也 是 要 在 BeatBox 应 用 中 复 阁 的 属性 。 回 到 styles.xml 文 件 中 ， 和 图 盖 
windowBackground 这 个 属性 ， 如 代码 清单 21-8 所 示 。 


代码 清单 21-8 设置 窗口 背景 Ces/values/styles.xml) 


«style name="AppTheme" parent="Theme.AppCompat"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark_red</item> 


<item name="colorAccent">@color/gray</item> 


<item name="android:windowBackground">@color/soothing blue</item> 
</style> 


注意 ，windowBackground 这 个 属性 来 自 Android 操 作 系 统 ， 别 二 了 使 
用 android 命 名 空间 。 


运行 BeatBox 应 用 。 滚 动 到 recycler 视 图 底部 查看 背景 ， 没 有 按钮 覆盖 的 


地 方 是 浅 蓝 色 ， 如 图 21-7 所 示 。 
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图 21-7 设置 了 主题 背景 的 BeatBox 


只 要 想 修 改 应 用 主题 ， 开 有 者 差不多 都 要 经 历 刚 才 得 


找 windowBackground 属 性 的 过 程 。 没 办 法 ， 这 些 属性 没 


考 ， 只 能 去 看 源 代 码 了 。 
总 结 一 下 ， 刚 才 我 们 定位 碍 看 了 以 下 主题 


e Theme.AppCompat 

e Base. Theme.AppCompat 

e Base.V7.Theme.AppCompat 
e Platform.AppCompat 


有 文档 可 参 


刚才 我 们 目下 而 上 逐 层 定位 ， 直 到 找到 AppCompat 根 主题 。 将 来 ， 越 来 
越 熟练 之 后 ， 你 很 可 能 会 跳 过 中 间 步 又 而 直达 目标 。 不 过 ， 建 议 还 是 按 
部 就 班 ， 以 此 看 清楚 究竟 哪个 是 根 主题 。 


最 后 再 提 个 醒 ， 主 题 继 承 关 系 和 层次 可 能 有 变故 布 新 系统 ) ， 但 上 面 
介绍 的 方法 不 会 变 。 想 要 知道 该 履 盖 哪个 属性 ， 就 沿 看 继承 树 找 吧 ! 


21.6 ”修改 按钮 属性 


前 面 ， 通 过 在 reslayouUlist_item_sound.xml 文 件 中 手动 设置 样式 属性 ， 
我 们 定制 过 BeatBox 应 用 的 按钮 。 如 果 一 个 复杂 应 用 在 很 多 activity 或 
fragment 中 有 按钮 ， 那 么 再 逐个 按钮 地 去 设置 style 属 性 就 很 不 应 该 
人 
TL AE SK e 


在 主题 里 添加 按钮 样式 前 ， 先 打开 reslayouUlist_item_sound.xml 文 件 ， 
删 掉 原 有 样式 属性 ， 如 代码 清单 21-9 所 示 。 


代码 清单 21-9 ” 删 挥 ! 有 更 好 的 办 法 了 


(res/layout/list_item_sound.xml ) 


— —style-"Qstyle/BeatBoxButten-Strong" = * i 


android: layout_width="match_parent" 

android: layout_height="12@dp" 

android: onClick="@{() -> viewModel.onButtonClicked()}" 
android: text="@{viewModel.title}" 

tools: text="Sound name"/> 


运行 BeatBox 应 用 。 可 以 看 到 ， 按 钮 回 到 原来 的 模样 了 ， 如 图 21-8 所 
示 。 
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A21-8 回 到 了 从 前 


再 次 逐 级 定位 得 找 主题 。 这 次 ， 我 们 找到 Base.V7.Theme.AppCompat 
里 的 buttonStyle 属 性 。 


<style name="Base.V7.Theme.AppCompat" parent="Platform.AppCompat"> 

<!-- Button styles --> 

<item name="buttonStyle" >@style/Widget .AppCompat.Button</item> 

<item name="buttonStyleSmall">@style/Widget .AppCompat.Button.Small</ite 


dfstyles 
这 个 属性 指定 应 用 中 普通 按钮 的 样式 。 
这 个 buttonSsty1le 属 性 没有 设置 值 ， 而 是 指向 了 一 个 样式 资源 。 前 面 履 


盖 windowBackground 属 性 时 ， 直 接 传 入 了 颜色 值 。 这 

里 ，buttonsty1le 应 该 指 同 另 一 个 样式 。 定 位 并 得 

看 Nidget.AppCompat.Button 样 式 。 如 果 不 能 使 用 快捷 键 
CCommand+click 或 Ctrl+click) 点 击 buttonSsty1le 属 性 定义 ， 请 直接 在 
values.xml 文 件 里 找到 它 的 样式 定义 。 


«style name-"Widget.AppCompat.Button" parent-"Base.Widget.AppCompat.Button" 


Widget.AppCompat.Button 样 式 没 有 定义 任何 属性 ， 继 续 定位 找 其 指 
回 的 父 样式 。 你 会 发 现 有 两 个 版 本 可 选 ， 选 values/values.xml 版 本 。 


«style name-"Base.Widget.AppCompat.Button" parent="android:Widget"> 
«item name-"android:background"»()drawable/abc btn default mtrl shape«/i 
«item name="android:textAppearance">?android: attr/textAppearanceButton< 
<item name="android:minHeight">48dip</item> 
«item name="android:minWidth">88dip</item> 
«item name="android: focusable">true</item> 
«item name="android: clickable" >true</item> 
«item name-"android:gravity"»center verticallcenter horizontal«/item» 
«/style» 


BeatBox 应 用 的 所 有 按钮 都 使 用 了 这 些 属性 。 

在 BeatBox 应 用 里 复 用 Android 上 自身 主题 。 修 改 BeatBoxButton 样 式 的 父 
样式 为 Widget.AppCompat.Button。 另 外 ， 删 

除 BeatBoxButton.Strong 样 式 ， 如 代码 清单 21-10 所 示 。 


代码 清单 21-10 ”创建 按钮 样式 (res/values/styles.xml) 


<resources> 


«style name="AppTheme" parent="Theme.AppCompat"> 
<item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark_red</item> 
<item name="colorAccent">@color/gray</item> 


«item name="android:windowBackground">@color/soothing blue</item> 
</style> 


«style name-"BeatBoxButton" parent="Widget .AppCompat.Button" > 
«item name="android: background" >@color/dark_blue</item> 
</style> 


</resources> 


继承 Widget .AppCompat .Button 样 式 ， 融 是 首先 让 所 有 按钮 都 继承 种 
规 按 钮 的 属性 。 然 后 根据 需要 ， 有 选择 性 地 修改 一 些 属性 。 


如 采 不 指定 BeatBoxButton 样 式 的 父 样式 ， 所 有 按钮 就 会 变 得 不 再 像 按 
钮 ， 连 按钮 中 间 显 示 的 文字 都 会 丢失 。 


BeatBoxButton 样 式 已 重新 定义 完毕 ， 可 以 使 用 了 。 经 过 前 面 对 主 题 的 
深 挖 ， 我 们 知道 要 履 盖 buttonSstyle 属 性 。 下 面 履 盖 buttonSty1le 属 
性 ， 让 它 指 向 BeatBoxButton 样 式 ， 如 代码 清单 21-11 所 示 。 


代码 清单 21-11 使 用 BeatBoxButton 样 式 (res/values/styles.xml) 


<resources> 


«style name="AppTheme" parent="Theme.AppCompat"> 
<!-- Customize your theme here. --> 
«item name="colorPrimary">@color/red</item> 
<item name="colorPrimaryDark">@color/dark_red</item> 
<item name="colorAccent">@color/gray</item> 


<item name="android:windowBackground">@color/soothing blue</item> 
<item name="buttonStyle" >@style/BeatBoxButton</item> 
</style> 


«style name-"BeatBoxButton" parent="Widget .AppCompat.Button"> 
«item name="android: background" >@color/dark_blue</item> 
</style> 


</resources> 


注意 ， 定 义 buttonStyle 时 ， 我 们 没有 使 用 android: 前 级 。 这 是 因 
为 ， 要 履 盖 的 buttonSsty1le 属 性 是 在 AppCompat 库 里 实现 的 。 


现在 ，buttonSsty1le 属 性 已 被 覆盖 ， 你 使 用 了 自 定 义 的 


BeatBoxButton. 


运行 BeatBox 应 用 ， 所 有 的 按钮 都 变 成 了 深蓝 色 ， 如 图 21-9 所 示 。 没 有 
oe 布局 ， 就 改变 了 普通 按钮 的 样子 。Android 主 题 属 性 太 强 
! 
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图 21-9 ” 带 最 终 版 主题 的 BeatBox 


按钮 没有 轮廓 ， 很 不 明显 。 
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下 一 章 会 做 美化 ， 让 它们 更 美观 。 


21.7 深入 学 习 : 样式 继承 拾遗 


本 章 前 面 对 样 式 继承 知识 点 的 介绍 还 不 够 全 面 。 在 进行 主题 探秘 时 ， 你 
可 能 已 经 注意 到 了 ， 样 式 继承 的 表示 法 时 有 切换 。AppCompat 主 题 都 是 
使 用 主题 名 表示 继承 ， 直 到 碰 到 Platform.AppCompat 这 个 主题 。 


«style name-"Platform.AppCompat" parent="android: Theme.Holo"> 


</style> 


这 里 ， 继 承 是 直接 使 用 parent 属 性 来 表示 的 。 为 什么 呢 ? 


要 以 主题 名 的 形式 指定 父 主题 ， 有 继承 关系 的 两 个 主题 都 应 处 于 同一 个 
包 中 。 因 此 ， 对 于 Android 操 作 系 统 内 部 主题 间 的 继承 ， 就 可 以 直接 使 
用 主题 名 继承 表示 法 。 同 理 ，AppCompat 库 内 部 也 是 这 样 。 人 然而， 一旦 
AppCompat 库 要 跨 库 继承 ， 束 一 定 要 明确 使 用 parent 属 性 。 


在 开发 自己 的 应 用 时 ， 应 遵守 同样 的 规则 。 如 果 是 继承 自己 内 部 的 主 
题 ， 使 用 主题 名 指定 父 主题 即 可 ;如 果 是 继承 Android 操 作 系 统 中 的 样 
式 或 主题 ， 记 得 使 用 parent 属 性 。 

21.8 深入 学 习 : 引用 主题 属性 

在 主题 中 定义 好 属性 后 ， 可 以 在 XML 或 代码 中 直接 使 用 它们 。 

为 了 在 XML 中 引用 主题 属性 ， 我 们 使 用 第 8 章 中 
listSeparatorTextViewStyle 属 性 用 到 的 符 写 。 在 XML 中 引用 具体 
值 〈《 比 如 颜色 值 ) 时 ， 我 们 使 用 @ 符 号 。@color/gray 指 向 某 个 特定 资 


在 主题 中 引用 资源 时 ， 使 用 ?符号 。 


<Button xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: id="@+id/list_item_sound_button" 
android: layout_width="match_parent" 
android: layout_height="12@dp" 
android: background="?attr/colorAccent" 
tools: text="Sound name"/> 


上 述 XML 中 ?符号 的 意思 是 使 用 colorAccent 属 性 指向 的 资源 。 这 里 是 
指定 义 在 colors.xml 文 件 中 的 灰色 。 


也 可 以 在 代码 中 使 用 主题 属性 ， 但 是 比较 喝 唆 。 


val theme: Resources.Theme = activity.theme 
val attrsToFetch = intArrayOf(R.attr.colorAccent) 


val a: TypedArray = theme.obtainStyledAttributes(R.style.AppTheme, attrsToF 
val accentColor = a.getInt(0, 0) 
a.recycle() 


先 取得 Theme 对 象 ， 然 后 要 求 它 找 到 定义 

在 AppTheme 〈 即 R.style.AppTheme) 中 的 R.attr.colorAccent 属 
性 。 结 果 得 到 一 个 持 有 数据 的 TypedArray 对 象 。 接 着 ， 向 TypedArray 
对 象 索要 颜色 Int 值 以 取出 颜色 。 颜 色 值 取 出 之 后 就 可 以 使 用 了 ， 比 
如 ， 用 来 更 改 按钮 背景 色 。 


E 中 的 工具 栏 和 按钮 就 是 采取 上 述 方 式 使 用 主题 属性 美化 自 
EH. 


第 22 瘟 XML drawable 


BeatBox 应 用 的 主题 设置 好 了 ， 下 面 该 优化 按钮 了 。 


当前 ， 按 钮 就 是 个 蓝 方 框 ， 点 击 它 也 看 不 到 任何 反应 。 本 章 ， 我 们 将 学 
习 使 用 XML drawable， 继 续 美化 BeatBox 应 用 ， 让 它 拥 有 如 图 22-1 所 示 
的 用 户 界 面 。 
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图 22-1 完全 改观 的 用 户 界 面 
在 Android 世 界 里 ， 凡 是 要 在 屏幕 上 绘制 的 东西 都 可 以 叫 作 drawable， 比 


OG AR. DrawableRiIN FAM. MARRS. AE, (LSE 
到 更 多 的 drawable: shape drawable, state list drawable£illayer list 


drawable。 这 三 个 drawable 都 定义 在 XML 文件 中 ， 可 以 归 为 一 类 ， 统 称 
为 XML drawable. 


22.1 统一 按钮 样式 


定义 XML drawable 之 前 ， 先 修改 res/layout/list_item_sound.xml 文 件 隔 开 
按钮 ， 如 代码 清单 22-1 所 示 。 


代码 清单 22-1 隔 开 按钮 (res/layout/list_item_sound.xml) 


<layout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 
<variable 
name-"viewModel" 
type-"com.bignerdranch.android.beatbox.SoundViewModel"/» 


«/data» 
«FrameLayout 
android:layout widthz"match parent" 
android:layout height-"wrap content" 
android: layout_margin="8dp"> 
<Button 


android: layout_width="10@dp" 
android: layout_height="10@dp" 
android: layout_gravity="center" 
android: onClick="@{() -> viewModel.onButtonClicked() }" 
android: text="@{viewModel.title}" 
tools:text="Sound name"/> 
</FrameLayout> 
</layout> 


现在 ， 按 钮 的 宽 和 高 都 是 100dp。 这 样 ， 稍 后 变 为 圆 形 时 ， 这 些 按钮 束 
DREN Y. 


不 论 屏幕 大 小 ，recycler 视 图 总 是 显示 三 列 按钮 。 如 果 还 有 多 余 的 空 
间 ， 它 会 拉 伸 列 格 以 适 配 屏幕 。 不 过 ，BeatBox 应 用 的 按钮 不 应 拉 伸 ， 
我 们 把 它们 封装 在 frame 布 局 里 。 这 样 ，frame 布 局 会 被 拉 伸 ， 而 按钮 不 
人 全。 


运行 BeatBox 应 用 。 按 钮 的 尺寸 都 完全 统一 了 ， 彼 此 之 间 还 留 出 了 空 
间 ， 如 图 22-2 所 示 。 
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图 22-2 MEI AIZEN 


22.2 shape drawable 


使 用 ShapeDrawable， 可 以 把 按钮 变 圆 。XML drawable 和 屏幕 像素 密 


度 无 关 ， 无 须 考虑 创建 特定 像素 密度 目录 ， 直 接 把 它 放 入 默认 的 
drawable (Fe RAT LA T o 


打开 项 目 工具 窗口 ， 在 res/drawable 目 录 下 创建 一 个 名 为 
button_beat_box_normal.xml 的 文件 ， 如 代码 清单 22-2 所 示 。 “〈 稍 后 还 会 
创建 一 个 “ 非 正 常 * 的 文件 ， 因 而 文件 名 里 有 normal 字 样 。) 


代码 清单 22-2 创建 圆 形 


drawable (res/drawable/button beat box normal.xml) 


<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="oval"> 


<solid android:color="@color/dark_blue"/> 


</shape> 


该 XML 文件 定义 了 一 个 背景 为 深蓝 色 的 圆 形 。 也 可 使用 shape drawable 
定制 其 他 各 种 图 形 ， 比 如 长 方形 、 线 条 以 及 梯形 等 。 


在 styles.xml 中 ， 使 用 新 建 的 button_beat_box_normal 作 为 按钮 背景 ， 
如 代码 清单 22-3 所 示 。 


代码 清单 22-3 ”修改 按钮 背景 〈res/values/styles.xml ) 


<resources> 
«style name="AppTheme" parent="Theme.AppCompat" > 
</style> 


«style name-"BeatBoxButton" parent="Widget .AppCompat.Button"> 


«item name="android: background" >@drawable/button_beat_box_normal</i 
</style> 


</resources> 


JBeatBox 应 用 。 可 以 看 到 ， 圆 形 的 按钮 出 现 了 ， 如 图 22-3 所 示 。 


(Ni 
S 
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图 22-3 [HET 
点 击 按钮 之 后 会 听 到 播放 的 声音 ， 可 按钮 的 样子 没有 任何 变化 。 如 果 按 
钮 按 下 去 的 样子 能 够 表现 出 来 ， 用 户 体验 则 会 更 好 。 


22.3 state list drawable 
为 解决 这 个 问题 ， 首 先 定义 一 个 用 于 按钮 按 下 状态 的 shape drawable. 
在 res/drawable 目 录 下 再 创建 一 个 名 为 button_beat_ box_pressed.xml 的 文 


件 ， 如 代码 清单 22-4 所 示 。 除 了 背景 颜色 是 红色 外 ， 这 个 shape drawable 
和 前 面 的 正常 版 本 一 样 。 


代码 清单 22-4 定义 按钮 按 下 时 的 shape 


drawable (res/drawable/button beat box pressed.xml) 


«shape xmlns:android-"http://schemas.android.com/apk/res/android" 
android: shape="oval"> 


«solid android: color="@color/red"/> 


</shape> 


接 下 来 ， 要 在 按钮 按 下 时 使 用 这 个 新 建 的 shape drawable。 这 需要 用 到 


state list drawable. 


根据 按钮 的 状态 ，state list drawable 可 UWIS le] A [a] drawable. $244 
没有 按 下 的 时 候 指向 button_beat_box_normal， 按 下 的 时 候 就 指 
|button beat box pressed. 


在 res/drawable 目 录 中 ， 和 定义 一 个 state list drawable， 如 代码 清单 22-5 所 


ZN o 


代码 清单 22-5 ”创建 一 个 state list 


drawable (res/drawable/button_beat_box.xml ) 


«selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:drawable="@drawable/button_beat_box_pressed" 


android:state_pressed="true"/> 
<item android:drawable-"()gdrawable/button beat box normal" /> 
</selector> 


现在 ， 在 styles.xml 中 修改 按钮 样式 ， 改 用 button_beat_box 作 为 按钮 
背景 ， 如 代码 清单 22-6 所 示 。 


代码 清单 22-6 ”使 用 state list drawable (res/values/styles.xml ) 


<resources> 


«style name="AppTheme" parent="Theme.AppCompat"> 
</style> 


«style name-"BeatBoxButton" parent="Widget .AppCompat.Button"> 


«item name="android: background" >@drawable/button_beat_box</item> 
</style> 


</resources> 


按钮 没有 按 下 的 时 候 使 用 button_beat_box_normal 做 背景 ， 按 下 时 就 
使 用 button_beat_box_pressed 做 背景 。 


运行 BeatBox 应 用 。 查 看 按钮 按 下 状态 的 按钮 背景 ， 如 图 22-4 所 示 。 
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图 22-4 按 下 状态 的 按钮 


除了 按 下 状态 ，state list drawable 3c RAH, RAUL BS ERA. 


22.4 layer list drawable 


BeatBox 应 用 看 起 来 挺 不 错 了 。 按 钮 圆 圆 的 ， 按 下 时 还 有 视 沉 反馈。 不 
过 ， 还 要 精益 求 精 。 

layer list drawable 能 让 两 个 XML drawable 合 二 为 一 。 借 助 这 个 工具 ， 可 
以 为 按 下 状态 的 按钮 添加 一 个 深 色 的 圆 环 ， 如 代码 清单 22-7 所 示 。 


代码 清单 22-7 使 用 layer list 


drawable (res/drawable/button_beat_box_pressed.xml ) 


<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
<item> 
<shape 


android: shape="oval"> 


«solid android: color="@color/red"/> 


</shape> 
</item> 
<item> 
<shape android: shape="oval"> 


<stroke android:width="4dp" 
android: color="@color/dark_red"/> 
</shape> 
</item> 
</layer-list> 


现在 ，layer list drawable 中 指定 了 两 个 drawable。 第 一 个 是 和 以 前 一 样 的 
红 圈 。 第 二 个 则 会 绘制 在 第 一 个 圈 上 ， 它 定义 了 一 个 4dp 粗 的 深 红 圈 。 
这 会 产生 一 个 蜡 红 的 圈 。 


这 两 个 drawable 可 以 组 成 一 个 layer list drawable。 当 然 也 可 以 使 用 多 个 ， 
那 会 获得 一 些 更 复杂 的 效果 。 


运行 BeatBox 应 用 ， 随 意 点 击 几 个 按钮 。 可 以 看 到 ， 在 按 下 状态 ， 按 钮 


有 了 漂亮 的 边 圈 ， 如 图 22-5 所 示 。 
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图 22-5 最 终 版 BeatBox 
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现在 ，BeatBox 应 用 真正 完成 了 。 还 记得 应 用 最 初 的 样子 吗 ? 两 相对 
比 ， 简 直 云 泥 之 别 。 显 然 ， 精 美的 应 用 让 人 用 起 来 舒心 ， 更 容易 获得 用 


户 的 青睐 。 


225 ”深入 学 习 : 为 什么 要 用 XML drawable 


应 用 总 需要 切换 按钮 状态 ， 因 此 state list drawable 是 Android 开 发 不 可 或 
缺 的 工具 。 那 shape drawable 和 1layer list drawable 呢 ?应 该 用 吗 ? 


XML drawable 用 起 来 方便 灵活 ， 不 仅 用 法 多 样 ， 还 易于 更 新 维护 。 搭 配 


使 用 shape drawable#lllayer list drawable 可 以 做 出 复杂 的 背景 图 ， 连 图 像 
编辑 器 都 省 了 。 更 改 BeatBox 应 用 的 配色 更 是 简单 ， 直 接 修改 XML 
drawable 中 的 颜色 就 行 了 。 


另外 ，XML drawable 独 立 于 屏幕 像素 密度 ， 可 在 不 带 屏幕 密度 资源 修饰 
符 的 drawable 目 录 中 直接 定义 。 如 果 是 普通 图 像 ， 就 需要 准备 多 个 版 
本 ， 以 适 配 不 同 屏幕 像素 密度 的 设备 ; 而 XML drawable 只 要 定义 一 次 ， 
就 能 在 任何 设备 的 屏幕 上 表现 出 色 。 


22.6 ”深入 学 习 : 使 用 mipmap 图 像 


资源 修饰 从 和 drawable 用 起 来 都 很 方便 。 应 用 要 用 到 图 像 ， 就 针对 不 同 

的 设备 尺寸 准备 不 同 尺寸 的 图 片 ， 再 分 别 放 入 drawable-mdpi 和 drawable- 
hdpi 这 样 的 文件 夹 。 然 后 ， 按 名 字 引 用 它们 。 剩 下 的 就 交 给 Android T, 

它 会 根据 当前 设备 的 屏幕 密度 调用 相应 的 图 片 。 


但 是 ， 有 个 问题 不 得 不 提 。 发 布 应 用 到 Google 应 用 商店 时 ，APK 文 件 包 
含 了 项 目 drawable 目 录 里 的 所 有 图 片 。 这 里 面 有 些 图 片 甚至 从 来 不 会 用 
到 。 这 是 个 负担 。 


为 解决 这 个 问题 ， 有 人 想到 针对 设备 定制 APK， 比 如 mdpi APK 一 个 ， 
hdpi APK 一 个 ， 等 等 。 


但 问题 解决 得 不 够 彻底 。 假 如 想 保留 各 个 屏幕 像素 密度 的 启动 图 标 呢 ? 


Android 局 动 器 是 个 党 驻 主屏 幕 的 应 用 〈 详 见 第 23 章 ) 。 点 击 设备 的 主 
屏幕 键 ， 会 回 到 启动 器 应 用 界面 。 


有 些 新 版 局 动 器 会 显示 大 尺寸 应 用 图 标 。 想 让 大 图 标清 晰 好 看 ， 启 动 絮 
号 得 使 用 更 高 分 辩 率 的 图 标 。 对 于 hdpi 设 备 ， 要 显示 大 图 标 ， 局 动 右 束 
会 使 用 xhdpi 图 标 。 如 果 找 不 到 ， 就 只 能 使 用 低 分 辨 率 的 图 标 。 


可 想 而 知 ， 放 大 拉 伸 后 的 图 标 肯 定 很 糟 。 
Android 解 决 这 个 问题 的 办 法 是 使 用 mipmap 目 录 。 如 果 你 启用 APK 分 


包 ，mipmap 目 录 就 不 会 从 APK 里 删除 。 否 则 ，mipmap 目 录 束 和 
drawable 目 录 没 有 区 别 了 。 


Android Studio 中 的 新 项 目 会 自动 使 用 mipmap 资 源 作 为 应 用 的 局 动 图 
标 ， 如 图 22-6 所 示 。 


res 
drawable 
layout 
mipmap 
ic_launcher (6) 
= ic_launcher.png (hdpi) 
=| ic launcher.png (mdpi) 
z ic launcher.png (xhdpi) 
=| ic launcher.png (xxhdpi) 
= ic launcher.png (xxxhdpi) 
ex ic launcher.xml (anydpi-v26) 
ic launcher. round (6) 
=| ic launcher round.png (hdpi) 
=| ic launcher round.png (mdpi) 
=| ic launcher round.png (xhdpi) 
=| ic launcher round.png (xxhdpi) 
= ic launcher round.png (xxxhdpi) 
&x ic launcher. round.xml (anydpi-v26) 
values 


[UI] 


22-6 mipmap 图 标 


据 此 ， 我 们 推荐 的 做 法 是 : 把 应 用 启动 器 图 标 放 在 各 个 mipmap 目 录 
中 ， 其 他 图 片 都 放 在 各 个 drawable 目 录 中 。 


22.7 深入 学 习 : 使 用 9-patch 图 像 


有 时 候 (也 可 能 经 常 )》， 按 钮 背景 图 必须 用 到 普通 图 片 。 那 么 ， 如 果 按 
钮 需要 以 不 同 太 寸 显 示 ， 背 景 图 该 如 何 变化 呢 ? 如 果 按 钮 的 宽度 大 于 背 
景 图 的 宽度 ， 图 片 就 会 被 拉 伸 。 拉 伸 的 图 片 会 有 很 好 的 效果 吗 ? 


朝 一 个 方 癌 拉 伸 背 景 图 很 可 能 会 让 图 片 失 去 原样 ， 所 以 得 想 个 办 法 控制 
图 片 拉 伸 方式 。 

本 节 ， 为 改造 BeatBox 应 用 按钮 ， 我 们 使 用 9-patch 图 片 做 其 背景 〈 不 明 
白 没 关系 ， 稍 后 就 知道 了 ) 。 注 意 ， 之 所 以 改造 ， 并 不 是 说 9-patch 更 适 
合 BeatBox 。 我 们 仅仅 是 想 告诉 你 9-patch 是 如 何 工作 的 ， 在 将 来 需要 的 


时 候 ， 你 该 如 何 使 用 它 。 


首先 ， 修 改 list_item_sound.xml 文 件 ， 人 允许 按钮 随 屏 幕 大 小 动态 调整 ， 如 
代码 清单 22-8 所 示 。 


代码 清单 22-8 ”人 允许 拉 伸 按钮 (reslayouUlist_item_sound.xml) 


«layout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools"> 
<data> 


<variable 
name="viewModel" 
type="com.bignerdranch. android. beatbox. SoundViewModel"/> 


</data> 
<FrameLayout 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android: layout_margin="8dp"> 
<Button 


android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: layout_gravity="center" 
android: onClick="@{() -> viewModel.onButtonClicked()}" 
android: text="@{viewModel.title}" 
tools:text="Sound name"/> 
</FrameLayout> 
</layout> 


调整 后 ， 按 钮 会 使 用 多 余 空 间 ， 按 钮 的 间隔 还 是 gdp。 新 按钮 背景 图 有 
个 折 角 和 阴影 ， 如 图 22-7 所 示 ， 这 是 按钮 的 新 背景 图 。 


图 22-7 新 背景 图 (res/drawable- 
xxhdpi/ic_button_beat_box_default.png) 


在 随 书 文件 的 xxhdpi drawable 目 录 里 (对 应 本 章 ) ， 找 到 包括 按 下 状态 
在 内 的 两 个 新 背景 图 ， 复 制 到 BeatBox 项 目的 drawable-xxhdpi 目 录 中 。 
然后 修改 button_beat_box.xml 文 件 使 用 它们 ， 如 代码 清单 22-9 所 示 。 


代码 清单 22-9 使 用 新 背景 图 (res/drawable/button_beat_box.xml) 


«selector xmlns:android="http://schemas.android.com/apk/res/android"> 


<item android:drawable-"()gdrawable/ic button beat box pressed" 
android:state pressed-"true"/» 


<item android:drawable-"()gdrawable/ic button beat box default" 
</selector> 


运行 应 用 ， 查 看 按钮 显示 效果 ， 如 图 22-8 所 示 。 
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图 22-8 ”难看 的 背景 图 
这 也 太 如 了 吧 ! 


为 什么 这 么 丑 ? 原 来 ，Android 向 四 面 拉 伸 了 
ic_button_beat_box_default.pn， 包 括 折 边 和 圆 角 。 要 是 能 控制 该 拉 伸 的 
部 分 拉 伸 ， 不 该 拉 伸 的 不 拉 伸 就 好 了 。 


使 用 9-patch 图 像 能 解决 这 个 问题 。9-patch 图 像 是 一 种 特别 处 理 过 的 文 
件 ， 能 让 Android 知 道 图 像 的 哪些 部 分 可 以 拉 伸 ， 哪 些 部 分 不 可 以 。 只 
要 处 理 得 当 ， 就 能 确保 背景 图 的 边 角 与 原始 图 像 保 持 一 致 。 


为 什么 要 叫 作 9-patch 呢 ? 9-patch 图 像 分 成 3 x 3 的 网 格 ， 即 由 9 部 分 或 9 
patch 组 成 的 网 格 。 网 格 角落 部 分 不 会 被 缩放 ， 边 缘 部 分 的 4 个 patch 只 按 
一 个 维度 缩放 ， 中 间 部 分 则 按 两 个 维度 缩放 ， 如 图 22-9 所 示 。 


图 22-9 9-patch 拉 伸 原 理 


9-patch 图 像 和 普通 PNG 图 像 十 分 相似 ， 只 有 两 处 不 同 : 9-patch 图 像 文 件 
名 以 .9.png 结 尾 ， 图 像 边缘 具有 1 像素 宽度 的 边框 。 这 个 边框 用 以 指定 9- 
patch 图 像 的 中 间 人 位置。 边框 像素 绘制 为 黑 线 ， 以 表明 中 间 位 置 ， 边 缘 部 
分 则 用 透明 色 表 示 。 


任意 图 形 编 辑 器 都 可 用 来 创建 9-patch 图 像 ， 比 如 Android SDK Et HY 
draw9patch 工 具 ， 或 直接 使 用 Android Studio。 


首先 ， 把 两 张 新 背 景 图 转换 为 9-patch 图 像 。 在 项 目 工具 窗口 中 ， 右 键 单 
击 ic_button_beat_box_default.png， 选 择 Refactor — Rename... 3# mAH 
改名 为 ic_button_beat_box_default.9.png。 〈 如 果 Android Studio 提 示 有 同 
名 资源 ， 直 接点 Continue 按 钮 继续 。) 再 用 相同 的 步骤 得 到 另 一 个 文 
件 : ic_button_beat_box_pressed.9.png. 


然后 ， 双 击 默认 图 片 在 Android Studio 内 置 的 9-patch 工 具 中 打开 ， 如 图 
22-10 所 示 。 (nR Android Studio 没 能 顺利 打开 9-patch 编 辑 器 ， 请 先 关 
闭 图 片 文件 ， 并 在 项 目 工 具 窗 口中 展开 drawable 目 录 ， 青 壬 试 重新 打开 
Ie) 


fE9-patch LAH, He, WERKA WEA, Show patches 选 项 。 然 
后 ， 把 图 像 顶 部 和 左边 框 填充 为 黑色 ， 以 标记 图 像 的 可 伸缩 区 域 ， 如 图 
22-10 所 示 。 你 也 可 以 拖 忠 色 边 去 匹配 图 像 。 


i stylesami X list Jtem_gound.xml X | i ie button beat box default a.png x — es oton beat boxxml 
Press Control/Shift while dragging on the border to modify layout bounds, 


Zoom: 100% 800% | ] Show lock C) Show content X57 px 


Patch scale 2x & E Show patches L] Show bad patches Y: Opx 


8-Patch  ImageFilsEditor 


图 22-10 ”创建 9-patch 图 像 

图 片 的 顶部 黑 线 指定 了 水 平方 回 的 可 拉 伸 区 域 。 左 边 的 黑 线 标记 在 竖 直 
m mU 图 片 被 各 种 拉 伸 会 是 什么 样 ， 可 参看 右边 的 
页 览 结果 。 


重复 上 述 步 骤 处 理 好 另 一 个 按 下 版 本 的 图 像 。 运 行 应 用 ， 看 看 9-patch 新 
图 是 什么 效果 ， 如 图 22-11 所 示 。 
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图 22-11 9-patch 图 像 使 用 效果 


顶部 以 及 左边 框 标记 了 图 像 的 可 拉 伸 区 域 ， 那么 后 部 以 及 右边 框 义 该 如 
何 处 理 呢 ? 它 们 定义 了 9-patch 图 像 的 可 选 内 容 区 。 内 容 区 是 绘制 内 容 
oo 的 地 方 。 如 果 不 标记 内 容 区 ， 那 么 默认 与 可 拉 伸 区 域 保 
T— 8t. 


使 用 内 容 区 让 按钮 上 的 文字 居中 。 现 在 继续 编辑 

ic button beat box_default.9.png， 如 图 22-12 所 示 ， 在 图 片上 添加 右边 和 
底部 两 条 线 。 同 时 色 选 Show content 选 项 。 这 个 选项 会 让 预览 器 高 亮 显 
示 图 片 的 文字 显示 区 。 


ic. button beat box. default.9.png 


Press Control/Shift while dragging on the border to modify layout bounds. 


Zoom: 10096 800% [)Showlock M Show content X: 0px 
Patch scale: — 2x 6x E Show patches | | Show bad patches Y: 155 px 


9-Patch | ImageFileEditor 


图 22-12 ”定义 内 容 区 


重复 上 述 步骤 处 理 好 另 一 个 按 下 版 本 的 图 像 。 仔 细 确 认 两 张 图 像 添 加 的 
内 容 区 黑 线 都 正确 一 致 。state list drawable 使 用 9-patch 图 片 时 (在 
BeatBox 应 用 中 ) ， 内 容 区 可 能 会 有 非 预 期 表现 。 按 钮 背景 图 初始 化 
时 ，Android 会 设置 内 容 区 内 容 ， 而 在 用 户 按 下 按钮 时 ， 内 容 区 内 容 很 
可 能 不 会 有 变化 。 这 说 明 ， 两 张 图 片 中 有 一 张 图 片 的 内 容 区 未 定义 。 这 
时 就 要 检查 看 看 ，state list drawable 使 用 的 所 有 9-patch 图 片 是 否 都 有 相 
同 的 内 容 区 。 


运行 BeatBox 应 用 ， 可 以 看 到 文字 都 居中 显示 了 ， 如 图 22-13 所 示 。 
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图 22-13 ”BeatBox 应 用 新 面貌 


试 着 模 屏 查看 应 用 。 可 以 看 到 ， 图 像 拉 伸 得 更 厉害 了 ， 不 过 控 钮 背景 
的 效果 依然 不 错 ， 文 字 依然 能 大 中 显示 。 


22.8 ”挑战 练习 : 按钮 主题 


完成 应 用 9-patch 图 片 更 新 后 ， 你 可 能 已 注意 到 ， 按 钮 的 背景 图 有 反 不 对 
I: 图 片 折 角 后 面 似乎 有 阴影 。 按 下 按钮 时 ， 它 会 向 你 的 手指 靠拢 。 


现在 ， 不 替换 背景 图 ， 去 掉 这 个 阴影 。 回 顾 前 面 学 的 主题 相关 知识 ， 看 
看 这 个 阴影 是 怎么 产生 的 。 再 思考 一 下 : 要 解决 这 个 问题 ， 有 没有 其 他 
按钮 样式 可 用 〔〈 作 为 BeatBoxButton 样 式 的 父 样式 ) 。 


第 23 草 深入 学 习 intent 和 任务 


本 章 将 使 用 隐 式 intent 创 建 一 个 新 应 用 ， 用 来 蔡 换 Android 的 默认 局 动 
器 。 新 应 用 名 为 NerdLauncher， 运 行 画面 如 图 23-1 所 示 。 
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[23-1 ”NerdLauncher 运 行 效果 图 


NerdLauncher 应 用 能 列 出 设备 上 的 其 他 应 用 。 点 选任 意 列 表 项 会 局 动 相 
应 应 用 。 


完成 该 应 用 能 帮 你 深入 理解 intent 和 intent 过 滤器 ， 搞 清楚 Android 应 用 间 
是 如 何 交 互 的 。 


23.1 创建 NerdLauncher 项 目 


在 Android Studio 中 ， 选 择 File > New > New Project... 荣 单项 创建 新 项 
目 。 选 择 Phone and Tablet 选 项 页 下 的 Add No Activity。 应 用 名 输入 
NerdLauncher， 包 名 输入 com.bignerdranch.android.nerdlauncher， 最 后 勺 
选 Use AndroidX artifacts， 保 持 其 余 默认 配置 完成 项 目 创建 。 


等 Android Studio 完 成 项 目 初始 化 工作 ， 选 择 File o New > Activity > 
Empty Activity 创 建 一 个 空 activity。 命 名 这 个 空 activity 为 
NerdLauncherActivity， 并 设置 其 为 启动 activity。 


NerdLauncherActivity 要 用 一 个 RecyclerView 来 显示 应 用 列表 。 在 
app/build.gradle 中 添加 androidx.recyclerview:recyclerview:1.0.0 依 赖 项 。 


如 代码 清单 23-1 所 示 ， 使 用 RecyclerView 蔡 换 
layout/activity_nerd_launcher.xml 中 的 布局 内 容 。 


代码 清单 23-1 更 新 NerdLauncherActivity 布 局 
(layout/activity_nerd_launcher.xml ) 


<?xml version-"1.0" encoding-"utf-8"?» 
«androidx.recyclerview.widget.RecyclerView 
xmlns:android-z"http://schemas.android.com/apk/res/android" 


android: id="@+id/app_recycler_view" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 


打开 NerdLauncherActivity.kt， 将 RecyclerView 对 象 存放 
在 recyclerView 成 员 变 量 中 ， 如 代码 清单 23-2 所 示 。〔 稍 后 会 处 
理 RecyclerView 的 数据 绑 定 。) 


代码 清单 23-2 基本 NerdLauncherActivity 实 现 
( NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 


private lateinit var recyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


setContentView(R.layout.activity nerd launcher) 


recyclerView - findViewById(R.id.app recycler view) 
recyclerView.layoutManager - LinearLayoutManager(this) 


运行 应 用 。 如 果 一 切 正 常 ， 可 看 到 如 图 23-2 所 示 的 用 户 界 
面 。RecyclerView 疝 未 绑 定数 据 ， 现 在 还 无 法 看 到 应 用 列表 。 
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同系 统 询问 ， 有 哪些 可 启动 的 主 activity。 


PackageManager〔 详 见 第 15 章 ) 可 用 来 获取 所 有 可 启动 主 activity。 可 

启动 主 activity 都 带 有 包含 MAIN 操 作 和 LAUNCHER 类 别 的 intent 过 滤器 。 在 
之 前 项 目的 manifests/AndroidManifest.xml 文 件 中 ， 你 已 见 过 这 种 intent 过 
滤器 : 


<intent-filter> 
«action android:name-"android.intent.action.MAIN" /> 


«category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter» 


在 设置 NerdLauncherActivity 为 启动 activity 的 时 候 ，Android Studio © 
自动 添加 了 这 些 intent 过 滤器 。 


在 NerdLauncherActivity.kt 中 ， 新 增 一 个 名 为 setupAdapter() 的 函数 ， 
然后 在 onCreate(. . .) 函 数 中 调用 它 。 (该 函数 最 终 还 会 创建 
RecyclerView.Adapter 实 例 并 设置 给 RecyclerView 对 象 。 现 在 ， 它 
只 会 生成 一 个 应 用 列表 。) 


另外 ， 再 创建 一 个 隐 Brad an ear a oe et 
有 activity。 最 后 ， 记 录 下 PackageManager 返 回 的 activity 总 数 ， 如 代码 
清单 23-3 所 示 。 


代码 清单 23-3 ”向 PackageManager 查 询 
( NerdLauncherActivity.kt) 


private const val TAG = "NerdLauncherActivity" 


class NerdLauncherActivity : AppCompatActivity() { 
private lateinit var recyclerView: RecyclerView 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


setContentView(R.layout.activity nerd launcher) 


recyclerView = findViewById(R.id.app recycler view) 
recyclerView.layoutManager - LinearLayoutManager(this) 


setupAdapter() 
} 


private fun setupAdapter() { 
val startupIntent = Intent(Intent.ACTION MAIN).apply { 


addCategory(Intent.CATEGORY LAUNCHER) 
j 


val activities - packageManager.queryIntentActivities(startupIntent 


Log.i(TAG, "Found ${activities.size} activities") 


这 里 ， 我 们 创建 了 一 个 操作 设 为 ACTION_MAIN、 类 别 设 
为 CATEGORY_LAUNCHER 的 隐 式 intent。 


调用 PackageManager.queryIntentActivities(Intent，Int) 会 返 
回 包 含 所 有 activity (有 匹配 目标 intent 的 过 滤器 ) 的 ResolveInfo 信 
息 。 例 如 ，PackageManager .GET_SHARED_LIBRARY_FILES 能 让 查询 
结果 附加 上 额外 数据 《关联 匹配 应 用 的 库 路 径 ) 。 这 里 传 入 的 是 6 参 
数 ， 表 示 不 打算 修改 查询 结果 。 


运行 NerdLauncher 应 用 ， 在 LogCat 窗 口 ， 看 看 PackageManager 返 回 多 
少 个 activity。 


在 Criminalmntent 必 用 中 ， 为 使 用 隐 式 intent 发 送 crime 报 告 ， 我 们 先 创建 
隐 式 intent， 再 将 其 封装 在 选择 器 intent 中 ， 最 后 调 
用 startActivity(Intent) 函 数 发 送 给 操作 系统 : 


val intent = Intent(Intent.ACTION_SEND) 
... // Create and put intent extras 


chooserIntent - Intent.createChooser(intent, getString(R.string.send report 
startActivity(chooserIntent) 


这 里 没有 使 用 上 述 处 理 方式 ， 是 不 是 很 费解 ? 原因 很 简单 : 
MAIN/LAUNCHER intent 过 滤器 可 能 无 法 与 通过 
startActivity(Intent) 函 数 发 送 的 MAINLAUNCHER 隐 式 intent 相 匹 
配 。 


事实 上 ，startActivity(Intent) 函 数 意味 着 “启动 匹配 隐 式 intent 的 


默认 activity”， 而 不 是 想当然 地 “局 动 匹 配 隐 式 intent 的 activity”。 调 
用 startActivity(Intent ) 函 数 

(akstartActivityForResult(...) KZO 发 送 隐 式 intent 时 ， 操 作 系 
统 会 悄悄 地 为 目标 intent 添 加 Intent .CATEGORY_DEFAULT 类 别 。 


Alt, meas iBintent peas UU startActivity (Intent) em ZU XX 
Kaxtintent, JL DUCES] NL Hinten thE ss FEL DEFAULTS J. 


4E X. f MAIN/LAUNCHER intent 过 滤器 的 activity 是 应 用 的 主要 入 口 点 。 
它 只 负责 做 好 作为 应 用 主要 入 口 点 要 处 理 的 工作 。 它 通常 不 关心 自己 是 
个 为 “默认 ”主要 入 口 点 ， 因 此 可 以 不 包含 CATEGORY_DEFAULT 类 别 。 


前 面 说 过 ，MAIN/LAUNCHER intent 过 滤器 并 不 一 定 包 

含 CATEGORY_DEFAULT 类 别 ， 因 此 不 能 保证 可 以 

与 startActivity(Intent) 函 数 友 送 的 隐 式 intent 罗 配 。 于 是 ， 我 们 转 
而 使 用 intent 直 接 向 PackageManager 查 询 带 有 MAIN/LAUNCHER intent 
过 滤器 的 activity。 


接 下 来 ， 需 要 在 NerdLauncherActivity 的 RecyclerView 视 图 中 显示 
查询 到 的 activity 标 签 。activity 标 签 是 用 户 可 以 识别 的 展示 名 。 既 然 查 询 
到 的 activity 都 是 启动 activity， 标 签名 通常 也 就 是 应 用 名 。 


在 PackageManager 返 回 的 ResolveInfo 对 象 中 ， 可 以 获取 activity 标 签 
和 其 他 一 些 元 数据 。 


tH. (&FAResolveInfo. loadLabel(PackageManager) i, Xf 
ResolveInfo 对 象 中 的 activity 标 签 按 首 字母 排序 ， 如 代码 清单 23-4 所 
示 。 


代码 清单 23-4 对 activity 标 俭 排序 CNerdLauncherActivity.kt ) 


class NerdLauncherActivity : AppCompatActivity() { 


private fun setupAdapter() { 
val startupIntent = Intent(Intent.ACTION MAIN).apply { 
addCategory (Intent .CATEGORY_LAUNCHER) 


j 


val activities - packageManager.queryIntentActivities(startupIntent 
activities.sortWith(Comparator ( a, b -> 


String.CASE INSENSITIVE ORDER.compare( 
a.loadLabel(packageManager).toString(), 
b.loadLabel(packageManager).toString() 


J) 


Log.i(TAG, "Found $(activities.size) activities") 


然后 ， 定 义 一 个 ViewHolder 用 来 显示 activity 标 签名 。 另 
外 ，ResolveInfo 信 息 经 常 要 用 ， 这 里 使 用 成 员 变量 存储 它 ， 如 代码 清 
单 23-5 所 示 。 


代码 清单 23-5 ”实现 ViewHolder (NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 
private fun setupAdapter() { 
} 


private class ActivityHolder(itemView: View) : 
RecyclerView.ViewHolder(itemView) { 


private val nameTextView = itemView as TextView 
private lateinit var resolveInfo: ResolveInfo 


fun bindActivity(resolveInfo: ResolveInfo) { 
this.resolveInfo = resolveInfo 


val packageManager = itemView.context.packageManager 
val appName - resolveInfo.loadLabel(packageManager).toString() 
nameTextView.text - appName 


接 下 来 实现 RecyclerView.Adapter， 如 代码 清单 23-6 所 示 。 


代码 清单 23-6 ”实现 
RecyclerView.Adapter (NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 


private class ActivityHolder(itemView: View) : 


} 


RecyclerView.ViewHolder(itemView) { 


private class ActivityAdapter(val activities: List<ResolveInfo>) : 


RecyclerView.Adapter<ActivityHolder>() { 


override fun onCreateViewHolder(container: ViewGroup, viewType: Int 
ActivityHolder { 
val layoutInflater = LayoutInflater.from(container.context) 
val view = layoutInflater 
.inflate(android.R.layout.simple list item 1, container, fa 
return ActivityHolder(view) 


} 


override fun onBindViewHolder(holder: ActivityHolder, position: Int 
val resolveInfo = activities[position] 
holder. bindActivity(resolveInfo) 

} 


override fun getItemCount(): Int { 
return activities.size 


我 们 在 onCreateViewHolder(...) 里 实例 化 
android.R.layout.simple_list_item_1 布 局 。simple_list_item_1 布 局 内 置 在 
Android 框 架 里 ， 因 此 ， 这 里 没有 使 用 R.layout， 而 是 用 了 
android.R.layout. 


最 后 ， 更 新 setupAdapter() 函 数 ， 创 建 一 个 ActivityAdapter 实 例 并 
配置 给 RecyclerView， 如 代码 清单 23-7 所 示 。 


代码 清单 23-7 为 RecyclerView 设 置 
adapter (NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 


private fun setupAdapter() { 


Log.i(TAG, "Found ${activities.size} activities") 
recyclerView.adapter = ActivityAdapter(activities) 


运行 NerdLauncher 应 用 。 现 在 ， 显 示 了 activity 标 签 的 RecyclerView 视 
图 出 现 了 ， 如 图 23-3 所 示 。 
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Clock 
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图 23-3 你 设备 上 的 全 部 activity 


23.3 ”在 运行 时 创建 显 式 intent 


上 一 节 ， 我 们 使 用 隐 式 intent 获 取 目 标 activity 并 以 列表 的 形式 展示 。 接 
下 来 要 实现 用 户 点 击 任 一 列表 项 ， 就 启动 对 应 的 activity。 这 次 需要 使 用 
显 式 intent 来 启动 activity。 


要 创建 启动 activity 的 显 式 intent， 需 要 从 ResolveInfo 对 象 中 获取 
activity 的 包 名 与 类 名 。 这 些 信息 可 以 从 ResolveInfo 对 象 的 
ActivityInfo 中 获取 。 0 中 还 可 以 获取 其 他 信息 ， 
具体 请 查阅 该 类 的 参考 文档 。) 


更 新 ActivityHolder 类 实现 一 个 点 击 监 昕 器 。 然 后 ， 在 用 户 点 击 某 个 
列表 项 时 ， 使 用 ActivityInfo 对 象 中 的 数据 信息 ， 创 建 一 个 显 式 intent 
并 局 动 目标 activity， 如 代码 清单 23-8 所 示 。 


代码 清单 23-8 局 动 目 标 activity (NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 


private class ActivityHolder(itemView: View) : 
RecyclerView.ViewHolder(itemView), 
View.OnClickListener { 


private val nameTextView - itemView as TextView 
private lateinit var resolveInfo: ResolveInfo 


init { 
nameTextView.setOnClickListener(this) 


} 


fun bindActivity(resolveInfo: ResolveInfo) { 


} 


override fun onClick(view: View) { 
val activityInfo = resolveInfo.activityInfo 


val intent = Intent(Intent.ACTION MAIN).apply { 
setClassName(activityInfo.applicationInfo.packageName, 
activityInfo.name) 


} 


val context = view.context 
context.startActivity(intent) 


注意 ， 作 为 显 式 intent 的 一 部 分 ， 我 们 还 发 送 了 ACTION_MAIN 操 作 。 发 


送 的 intent 是 否 包含 操作 ， 对 于 大 多 数 应 用 来 说 没有 什么 差别 。 不 过 ， 
有 些 应 用 的 启动 行为 可 能 会 有 所 不 同 。 取 决 于 不 同 的 启动 要 求 ， 同 样 的 
activity 可 能 会 显示 不 同 的 用 户 界 面 。 开 及 人 员 最 好 能 明确 司 动 意图 ， 以 
便 让 activity 完 成 它 应 该 完成 的 任务 。 


在 代码 清单 23-8 中 ， 使 用 包 名 和 类 名 创建 显 式 intent 时 ， 我 们 使 用 了 以 
“FiIntentex 24: 


fun setClassName(packageName: String, className: String): Intent 


这 和 以 往 创建 显 式 intent 的 方式 不 同 。 之 前 ， 我 们 使 用 的 是 接受 Context 
和 Class 对 象 的 Intent 构 造 函 数 : 


Intent(packageContext: Context, cls: Class<?>) 


该 构造 函数 使 用 传 入 的 参数 来 获取 Intent 需 要 的 
ComponentName。ComponentName 由 包 名 和 类 名 共同 组 成 。 传 

入 Activity 和 Class 创 建 Intent 时 ， 构 造 函 数 会 通过 Activity 类 自行 
确定 全 路 径 包 名 。 


fun setComponent(component: ComponentName): Intent 


不 过 ，setClassName(...) 函 数 能 够 自动 创建 组 件 名 ， 用 和 它 可 以 少 写 
不 少 代 码 呢 。 


运行 NerdLauncher 应 用 并 尝试 启动 一 些 应 用 。 


23.4 任务 与 回 退 栈 


Android 使 用 任务 来 跟踪 应 用 运行 的 状态 。 通 过 Android 默 认 启 动 器 应 用 
打开 的 应 用 都 有 自己 的 任务 。 这 是 我 们 想 要 的 一 种 行为 。 然 而 ， 这 并 个 
适用 于 NerdLaucher 应 用 。 在 设法 让 NerdLaucher 应 用 中 局 动 的 应 用 也 能 
有 自己 的 任务 之 前 ， 先 来 搞 清楚 究竟 什么 是 任务 ， 它 是 如 何 工作 的 。 


任务 是 一 个 activity 栈 。 栈 底部 的 activity 通 常 称 为 基 activity。 栈 顶 的 
activity 用 户 能 看 得 到 。 如 果 按 回 退 键 ， 栈 顶 activity 会 弹 à 栈 外 。 如 果 用 
户 看 到 的 是 基 activity， 按 回 退 键 ， 系 统 就 会 回 到 主屏 幕 


默认 情况 下 ， 新 activity 都 在 当前 任务 中 启动 。 在 CriminalIntent 应 用 中 ， 
无 论 何 时 启动 新 activity， 它 都 会 被 添加 到 当前 任务 中 。 即 使 要 局 动 的 
activity 不 属于 CriminalIntent 应 用 (启动 其 他 activity 发 送 crime 报 告 〉》， 
它 同样 也 在 当前 任务 中 启动， 如 图 23-4 所 示 。 
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| crnminalntent 任 务 


点 击 CHOOSE MainActivity 


ce aia aa 
图 23-4  CriminalIntent4t 2& 


TE m o e 用 户 可 以 在 任务 内 而 不 是 在 应 用 层 
级 间 导 航 返回 ， 如 图 23-5 所 示 。 
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图 23-5 A h ENE g 
23.4.1 在 任务 间 切 换 


在 不 影响 各 个 任务 状态 的 情况 下 ， 概 览 屏 Coverview screen) 可 以 让 我 
们 在 任务 间 切 换 。 例 如 ， 一 开始 你 .在 录 联 系 人 信息 ， ZA Js tk Sil Twitter 
用 看 信息 ， 这 时 就 启动 了 两 个 任务 。 如 果 再 回 到 联系 人 应 用 ， 你 在 两 个 
任务 中 所 处 的 状态 都 会 被 保存 下 来 。 


耳闻 不 如 杀 见 ， 你 可 以 在 设备 或 模拟 器 上 试 试 使 用 概览 屏 切 换 任 务 。 首 
先 ， 从 主屏 幕 或 应 用 启动 器 中 局 动 CriminalIntent 应 用 。〈 如 果 设 备 或 模 
拟 器 上 的 应 用 已 人 印 载 ， 请 打开 Android Studio 中 的 CriminalIntent 项 目 并 运 
Als 


从 crime 列 表 中 选择 任意 列表 项 ， 然 后 ， 按 主屏 幕 键 回 到 主屏 幕 。 接 
着 ， 从 主屏 幕 或 应 用 启动 器 中 启动 BeatBox 应 用 。 最 后 ， 按 Recents 按 钮 
打开 概览 屏 ， 如 图 23-6 所 示 。 
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123-6 Nougat (Æ) #ilPie CA) 上 的 概览 屏 


如 果 是 Nougat (API 24%) Ke, APS P 6 左边 的 概览 屏 ， 如 
果 是 Pie (API 28 级 ) ， 则 会 看 到 右边 的 概览 屏 〈 只 要 他 们 没有 局 用 
Swipe up on Home 选 项 ) 。 


不 管 怎 样 ， 图 中 的 每 个 应 用 显示 项 (又 叫 应 用 卡片 就 代表 着 应 用 的 任 
务 。 这 些 任 务 当 前 显示 的 是 处 于 回 退 栈 顶 部 activity 的 快照 。 你 可 以 点 击 
BeatBox 或 CriminalIntent 卡 片 ， 人 返回 到 应 用 (或 应 用 里 你 之 前 与 之 交互 
的 任何 activity) 。 


要 清除 应 用 任务 ， 用 户 只 需 滑动 某 张 卡片 就 能 将 其 从 任务 列表 里 移 除 。 
清除 任务 会 从 应 用 回 退 栈 中 清除 所 有 activity。 


试 着 清除 CriminalIntent 心 用 任务 再 重启 。 重 局 后 ， 你 看 到 的 是 crime 列 表 
界面 ， 而 不 应 再 是 清除 前 的 crime 编 辑 界面 了 。 


23.4.2 ”启动 新 任务 


有 时 你 需要 在 当前 任务 中 启动 activity， 而 有 时 叉 需 要 在 新 任务 中 启动 
activity〈 独 立 于 局 动 它 的 activity) 。 


当前 ， 从 NerdLauncher 启 动 的 任何 activity 都 会 被 添加 到 NerdLauncher 任 
务 中 ， 如 图 23-7 所 示 。 
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图 23-7 NerdLauncher{t 4 F&S CriminalIntent/ Hj activity 


要 想 确 认 这 点 ， 可 先 清 除 概览 屏 显 示 的 所 有 任务 。 然 后 ， 启 动 
NerdLauncherJf. iiti CriminalIntent/W H1 44 JH z/)CriminalIntent H. BIA 


你 局 动 了 不 同 的 应 用 ， 但 是 再 次 打开 概览 屏 时 ， 只 能 看 到 一 个 任务 。 


CriminalIntent 应 用 的 MainActivity 启 动 后 ， 它 随即 就 被 添加 到 了 
NerdLauncher 任 务 中 ， 如 图 23-8 所 示 。 只 要 点 击 NerdLauncher 任 务 ， 你 
束 会 回 到 启动 概览 屏 之 前 所 在 的 CriminalIntent 用 户 界面 。 
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图 23-8  CriminalIntent/'/ Hj ££ NerdLauncher4£t 2$ 'H 


我 们 需要 NerdLauncher 在 新 任务 中 启动 activity， 如 图 23-9 所 示 。 这 样 ， 
点 击 NerdLauncher 局 动 器 中 的 应 用 项 可 以 让 应 用 拥有 自己 的 任务 ， 用 户 
就 可 以 通过 概览 屏 在 运行 的 应 用 间 自 由 切换 了 。 
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NerdLauncher 任 务 


图 23-9 ”让 CriminalIntent 在 自身 任务 里 局 动 


为 了 在 启动 新 activity 时 局 动 新 任务 ， 需 要 为 intent 洪 加 一 个 标志 ， 如 代 
码 清单 23-9 所 示 。 


代码 清单 23-9 ”为 intent 添 加 新 任务 标志 
(NerdLauncherActivity.kt) 


class NerdLauncherActivity : AppCompatActivity() { 


private class ActivityHolder(itemView: View) : 
RecyclerView.ViewHolder(itemView), 
View.OnClickListener { 


override fun onClick(view: View) { 
val activityInfo - resolveInfo.activityInfo 


val intent = Intent(Intent.ACTION MAIN).apply { 
setClassName(activityInfo.applicationInfo.packageName, 
activityInfo.name) 
addFlags(Intent.FLAG ACTIVITY NEW TASK) 


val context = view.context 
context.startActivity(intent) 


先 清 除 概览 屏 显 示 的 所 有 任务 ， 再 次 运行 NerdLauncher 必 用 并 启动 
CriminalIntent。 这 次 ， 如 果 启 动 概览 屏 ， 惑 会 看 到 CriminalIntent 心 用 处 
于 一 个 单独 的 任务 中 ， 如 网 23-10 所 示 。 
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如 果 从 NerdLauncher 应 用 中 再 次 启动 CriminalIntent 应 用 ， 也 不 会 创建 第 
二 个 CriminalIntent 任 务 。FLAG_ACTIVITY_NEW_TASK 标 志 控 制 每 个 
activity 仅 创建 一 个 任务 。MainActivity 己 经 有 了 一 个 运行 的 任务 ， 
此 Android 会 自动 切换 到 原来 的 任务 ， 而 不 是 创建 全 新 的 任务 。 


眼见 为 实 。 在 CriminalIntent 应 用 中 ， 打 开 任 意 crime 的 明细 界面 。 然 后 ， 


使 用 概览 屏 切 换 至 NerdLauncher。 点 击 应 用 列表 中 的 CriminalIntent。 可 
以 看 到 ，Criminalintent 应 用 中 打开 的 crimne 明 细 界 面 又 回来 了 。 


23.5 HjNerdLauncher 4 = 5f x 


没 人 愿意 通过 局 动 一 个 应 用 来 局 动 其 他 应 用 。 因 此 ， 以 蔡 换 Android 主 
界面 (home screen) 的 方式 使 用 NerdLauncher 应 用 会 更 合适 一 些 。 打 开 
NerdLauncher 项 目的 AndroidManifest.xml 文 件 ， 疝 intent 主 过 滤器 添加 以 
下 节点 定义 ， 如 代码 清单 23-10 所 示 。 


代码 清单 23-10 ”修改 NerdLauncherActivity 的 类 别 
(manifests/AndroidManifest.xml ) 


<intent-filter> 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /> 


«category android:name-"android.intent.category.HOME" /» 
«category android:name-"android.intent.category.DEFAULT" /> 
«/intent-filter» 


添加 HOME 和 DEFAULT 类 别 定义 后 ，NerdLauncherActivity 会 成 为 可 选 
的 主 界面 。 按 主屏 幕 键 可 以 看 到 ， 在 弹出 的 对 话 框 中 ，NerdLauncher 变 
成 了 主 界面 可 选项 ， 如 图 23-11 所 示 。 
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图 23-11 选择 主屏 幕 应 用 


如 果 已 设置 NerdLauncher 应 用 为 主 界面 ， 恢 复 系 统 默 认 设置 也 很 容易 。 
首先 ， 从 NerdLauncher 启 动 Settings 应 用 。 选 择 Settings ^ Apps & 
Notification 菜 单项 ， 然 后 从 应 用 列表 中 选择 NerdLauncher。 (如 果 应 用 
列表 中 看 不 到 NerdLauncher， 请 选择 See all apps 展 开 列 表 ， 翻 找到 


Eo ) 


选择 了 NerdLauncher 后 ， 在 应 用 的 信息 屏 展 开 Advanced 设 置 列表 ， 选 择 
Open by default， 然 后 点 击 CLEAR DEFAULTS 按 钮 。 下 次 再 按 主屏 幕 键 
时 ， 又 可 以 自主 选择 了 。 


23.6 ”深入 学 习 : 进程 与 任务 


对 象 需要 内 存 和 虚拟 机 的 支持 才能 生存 。 进 程 是 操作 系统 创建 的 、 供 应 
用 对 象 生存 以 及 应 用 运行 的 地 方 。 


进程 通常 会 拥有 由 操作 系统 管理 痢 的 一 些 系统 资源 ， 比 如 内 存 、 网 络 端 
口 以 及 打开 的 文件 等 。 进 程 还 拥有 至 少 一 个 〈 可 能 多 个 ) 执行 线程 。 在 
Android 系 统 中 ， 每 个 进程 都 需要 一 个 虚拟 机 来 运行 。 


Android 4.4 (KitKat) 之 前 ，Dalvik 是 Android 操 作 系 统 使 用 的 进程 虚拟 
机 。 进 程 只 要 一 启动 ， 束 会 有 一 个 Dalvik 虚 拟 机 新 实例 跳出 来 收留 它 。 
不 过 ， 自 Android 5.0 (Lollipop〉 开 始 ，Android 运 行 时 ART) 取代 了 
Dalvik， 已 成 为 公认 的 进程 虚拟 机 。 


尽管 存在 未 知 的 异常 情况， 但 总 的 来 说 ，Android 世 界 里 的 每 个 应 用 组 
件 都 仪 与 一 个 进程 相关 联 。 应 用 伴随 着 自己 的 进程 一 起 完成 创建 ， 该 进 
程 同 时 也 是 应 用 中 所 有 组 件 的 默认 进程 。 


《虽然 组 件 可 以 指派 给 不 同 的 进程 ， 但 我 们 推荐 使 用 默认 进程 。 如 果 确 
实 需 要 在 不 同 进程 中 运行 应 用 组 件 ， 通 常 也 可 以 借助 多 线程 来 实现 。 相 
比 多 进程 ，Android 多 线程 的 使 用 更 加 简单 。) 


每 一 个 activity 实 例 都 仅 存 在 于 一 个 进程 之 中 ， 同 一 个 任务 关联 。 这 也 是 
进程 与 任务 的 唯一 相似 之 处 。 任 务 只 包含 activity， 这 些 activity 通 和 来 目 
不 同 的 应 用 进程 ， 而 进程 包含 了 应 用 的 全 部 运行 代码 和 对 象 。 


进程 与 任务 很 容易 让 人 混 请 ， 主 要 原因 在 于 它们 不 仅 在 概念 上 有 某 种 重 
登 ， 而 且 通 常会 被 人 以 应 用 名 提 及 。 例 如 ， 从 NerdLauncher 局 动 器 中 局 
动 CriminalIntent 心 用 时 ， 操 作 系 统 创建 了 一 个 CriminalIntentj 进 程 以 及 一 
个 以 MainActivity 为 基 栈 activity 的 新 任务 。 在 概览 屏 中 ， 可 以 看 到 这 
个 任务 就 被 标 名 为 CriminalIntent。 


引用 着 activity 的 任务 和 activity 所 在 的 进程 有 可 能 会 不 同 。 以 
CriminalIntent 心 用 和 联系 人 应 用 为 例 ， 看 看 以 下 具体 场景 就 会 明白 了 。 


打开 CriminalIntent 心 用 ， 选 择 任 意 crime 项 〈 或 添加 一 条 crime 记 录 ) ， 

然后 点 击 CHOOSE SUSPECT 按 钮 。 这 会 打开 联系 人 应 用 让 你 选择 目标 

联系 人 。 随 即 ， 联 系 人 列表 activity 会 被 加 入 CriminalIntent 应 用 任务 中 。 

回 退 键 在 不 同 activity 间 切换 ， 用 户 可 能 意识 不 到 他 们 正在 进 
星 间 切换 。 


然而 ， 联 系 人 activity 实 例 实 际 是 在 联系 人 应 用 进程 的 内 存 空 间 创 建 的 ， 
而 且 也 是 在 该 应 用 进程 里 的 虚拟 机 上 运行 的 。activity 实 例 状 态 和 该 场景 
下 的 任务 引用 如 图 23-12 所 示 。 


MainActivity 


Contact List 
Activity 


(Criminallntent 应 用 进程 ) 


MainActivity 
实例 


(Contacts 应 用 进程 ) 


Contact List 
Activity 实 例 


图 23-12 ”任务 与 进程 一 对 多 的 关系 


为 进一步 了 解 进程 和 任务 的 概念 ， 让 CriminalIntent 应 用 运行 的 同时 ， 进 
入 联系 人 列表 界面 。 继 续 之 前 ， 请 确保 在 概览 屏 里 看 不 到 联系 人 应 
用 。) 控 主 屏 大 键 回 到 主屏 莫 ， 从 中 局 动 联系 人 应 用 。 然 后 从 联系 人 列 
表 中 选取 任意 联系 人 或 添加 新 联系 人 。 


在 这 个 操作 过 程 中 ， 系 统 会 在 联系 人 应 用 进程 中 创建 新 的 联系 人 列表 
activity 和 联系 人 明细 界面 实例 。 也 会 创建 联系 人 应 用 新 任务 。 这 个 新 任 
务 会 引用 联系 人 列表 和 联系 人 明细 界面 activity 实 例 ， 如 图 23-13 所 示 。 


(Criminallntent 应 用 进程 ) 


MainActivity 
实例 


MainActivity 


Contact List 
Activity 


(Contacts 应 用 进程 ) 
Contact List Contact List 
Activity Activity 实 例 


Contact Detail 
Actvity au Contact List 
Activity 245i) 


Contact Details 
a EE Te a E Activity 实 例 


图 23-13 ”进程 对 多 个 任务 


本 章 ， 我 们 创建 了 任务 并 实现 了 任务 间 的 切换 。 有 没有 想 过 符 换 
Android 默 认 的 概览 屏 呢 ? 很 遗憾 ， 做 不 到 ，Android 没 告诉 我 们 该 怎么 
做 。 另 外 ， 你 应 该 知道 ，Google Play 商店 中 一 些 自称 为 任务 终止 器 的 应 
用 ， 实 际 上 都 是 进程 终止 器 。 这 些 应 用 会 “ 杀 掉 ” 某 个 进程 ， 这 表明 ， 它 
们 可 能 正在 销毁 其 他 应 用 任务 引用 的 activity。 


23.7 深入 学 习 : 并 发 文档 


试 着 运行 CriminalIntent 应 用 并 在 应 用 间 分 享 crime 数 据 时 ， 打 开 概 览 屏 查 
看 任务 ， 你 会 发 现 一 些 有 趣 的 现象 。 例 如 ， 在 发 送 crime 消 息 时 ， 你 所 
选择 发 送 消息 应 用 的 activity 不 会 添加 到 CriminalIntent 应 用 任务 中 ， 而 是 
添加 到 它 自 己 的 独立 任务 中 ， 如 图 23-14 所 示 。 


b AUS | 


From bnrdevice@gmail.com 
To 

Criminallntent Crime Report 
somebody stol 


e my yogurt! The crime w: 
discovered on Fri, Nov 16. The case is not 
solved, and there is no suspect. 


[23-14 Gmail 处 于 独立 的 任务 中 


对 以 android.intent.action.SEND 
Mandroid.intent.action.SEND MULTIPLE )aayfMactivity, [aV 
intentit f as ll e ITA BME o 


这 种 行为 来 源 于 一 个 叫 作 并 发 文档 Cconcurrent document) 的 新 概念 。 
有 了 并 发 文档 ， 就 可 以 为 运行 的 应 用 动态 创建 任意 数目 的 任务 。 需 要 注 
意 的 是 ， 这 种 行为 是 在 Android Lollipop (API 级 别 21) 上 引入 的 。 如 果 
在 老 旧 设备 上 做 测试 ， 那 么 在 概览 屏 是 看 不 到 并 发 文档 的 。 在 Lollipop 
之 前 ， 应 用 的 任务 只 能 预先 定义 好 ， 而 且 还 要 在 manifest 文 件 中 指明 。 


Google Drive 就 是 并 发 文档 概念 应 用 的 最 好 实例 。 用 户 可 以 用 它 打开 并 
编辑 多 份 文档 。 从 概览 屏 可 以 看 到 ， 这 些 文档 编辑 activity 都 处 在 独立 的 


任务 中 ， 如 图 23-15 所 示 。 
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图 23-15 ”多 个 Google Drive 任 务 


如 果 需 要 应 用 局 动 多 个 任务 ， 可 采用 两 种 方式 : 给 intent 打 

上 Intent.FLAG_ACTIVITY_NEW_DOCUMENT 标 签 ， 再 调 

用 startActivity(...) 函 数 ， 或 者 在 manifest 文 件 中 ， 为 activity 设 置 
如 下 documentLaunchMode: 


<activity 
android: name=".CrimePagerActivity" 
android: label="@string/app_name" 
android: parentActivityName=".MainActivity" 


android: documentLaunchMode="intoExisting" /> 


使 用 上 述 方法 ， 一 份 文 档 只 会 对 应 一 个 任务 。 “如果 发 送 珊 有 和 已 存在 
任务 相同 数据 的 intent， 系 统 就 不 会 再 创建 新 任务 。 ) 如 有 果 无 论 如 何 都 
想 创建 新 任务 ， 那 束 给 intent 同 时 打 

上 Intent.FLAG ACTIVITY_NEW_DOCUMENT 和 
Intent.FLAG_ACTIVITY_MULTIPLE_TASK 标 签 ， 或 者 把 manifest 文 件 中 
的 documentLaunchMode 属 性 值 改 为 always。 


23.8 HRAJ: 应 用 图 标 


本 章 ， 为 在 启动 器 应 用 中 显示 各 个 activity 的 名 称 ， 我 们 使 用 了 
ResolveInfo.loadLabel(PackageManager)iK 2X. ResolveInfoit 
有 男 一 个 类 似 的 名 为 loadIcon() 的 函数 ， 你 可 以 用 它 为 每 个 应 用 加 载 
显示 图 标 。 作 为 练习 ， 请 给 NerdLauncher 应 用 中 显示 的 所 有 应 用 添加 图 
标 。 


第 24 音 HTTP 与 后 台 任 务 


言 息 时 代 ， 互 联网 应 用 占用 了 用 户 的 大 量 时 间 。 餐 损 上 无 人 交谈 ， 每 个 
人 都 只 顾 低头 摆弄 手机 。 一 有 时 间 ， 大 家 束 查 看 新 闻 推 送 、 收 发 短信 
上 息 ， 或 是 玩 网 络 游戏 。 

为 学 习 Android 网 络 应 用 的 开发 ， 我 们 来 创建 一 个 名 为 PhotoGallery 的 应 
用 。 作 为 图 片 共 享 网 站 Flickr 的 一 个 客户 问 应 用 ，PhotoGallery 能 获取 并 
展示 Flickr 网 站 的 最 新 公共 图 片 。 应 用 完成 后 的 界面 如 图 24-1 所 示 。 


9:00 


PhotoGallery 


图 24-1 PhotoGallery 应 用 最 终 效果 图 


PhotoGallery 应 用 有 过 滤 功 能 ， 只 能 展示 不 限 厂 权 的 图 片 。Flickr 网 站 
上 很 多 图 厂 归 上 传 者 私有 ， 使 用 它们 需 遵 守 使 用 许可 限制 条 球 。) 


接 下 来 的 几 章 会 学 习 开发 PhotoGallery 应 用 。 本 章 ， 你 将 学 习 如 何 使 用 
Retrofit 库 向 REST API 发 起 请 求 。 获 得 返回 JSON 数 据 后 ， 叉 该 如 何 使 用 
Gson 库 解析 成 Kotlin 对 象 。 当 前 ， 几 乎 所 有 网 络 服务 日 常 开 发 都 要 使 用 
HTTP 网 络 协议 。Retrofit 能 让 Android 应 用 以 类 型 安全 的 方式 访问 HTTP 
和 HTTP/2 网 络 服务 。 


本 章 结 束 时 ， 你 应 完成 的 任务 是 : 获取 、 解 析 以 及 显示 Flickr 图 片 的 标 
题 ， 如 图 24-2 所 示 。 下 一 章 ， 我 们 将 学 习 如 何 获 取 并 显示 图 片 。 
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9:00 


PhotoGallery 
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图 24-2 ”本 章 结束 时 的 成 果 


24.1 创建 PhotoGallery 心 用 


在 Android Studio 中 ， 选 择 File > New > New Project... 荣 单项 创建 新 项 
目 。 选 择 Phone and Tablet 选 项 页 下 的 Add No Activity。 应 用 名 输入 
PhotoGallery， 包 名 输入 com.bignerdranch.android.photogallery， 语 言 选择 
Kotlin, Minimum API level 选 择 API 21: Android 5.0 (Lollipop)， 最 后 义 选 
Use AndroidX artifacts， 保 持 其 余 默认 配置 完成 项 目 创建 。 


等 Android Studio 完 成 项 目 初始 化 工作 ， 选 择 File o New > Activity > 
Empty Activity 创 建 一 个 空 activity。 命 名 这 个 空 activity 
为 PhotoGalleryActivity， 并 设置 其 为 启动 activity。 


PhotoGalleryActivity 会 负责 托管 稍 后 就 创建 的 
PhotoGalleryFragment。 首 先 ， 打 开 
res/layoutactivity_photo_gallery.xml， 使 用 一 个 FrameLayout 和 定义 奉 换 系 
统 自 动 生成 的 布局 内 容 。 新 添加 的 FrameLayout 就 是 被 托管 fragment 的 
容器 视图 ， 其 布局 ID 是 fragmentContainer， 如 代码 清单 24-1 所 示 。 


代码 清单 24-1 添加 fragment 容 器 
(res/layout/activity photo gallery.xml) 


«?xml version-"1.0" encoding-"utf-8"?» 

«FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 


android: id="@+id/fragmentContainer" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
tools:context-".PhotoGalleryActivity"/» 


ftPhotoGalleryActivity.kt, #ronCreate(...) 2, fy rfrfragment 
容器 里 是 否 已 有 被 托管 的 fragment。 如 果 没 有 ， 就 创建 一 

个 PhotoGalleryFragment 实 例 并 把 它 添加 到 容器 里 ， 如 代码 清单 24-2 
所 示 。〈 有 错误 提示 没关系 ， 稍 后 创建 完 PhotoGalleryFragment 类 就 
AFT s 


代码 清单 24-2 配置 activity (PhotoGalleryActivity.kt) 


class PhotoGalleryActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity photo gallery) 


val isFragmentContainerEmpty - savedInstanceState -- null 
if (isFragmentContainerEmpty) { 
supportFragmentManager 
.beginTransaction() 
.add(R.id.fragmentContainer, PhotoGalleryFragment.newInstan 
. commit() 


在 CriminalIntent 应 用 中 ， 通 过 在 ragment 容 器 ID 上 调 

用 findFragmentById(...) 函 数 ， 我 们 判断 目标 fragment 容 器 里 是 否 已 
有 被 托管 的 fragment。 如 果 有 ， 就 不 用 再 添加 了 。 这 个 检查 很 有 必要 ， 
因为 发 生 设 备 配置 改变 或 者 出 现 系统 强 杀 应 用 进程 后 ，fragment 管 理 需 
会 目 动 重 建 被 托管 fragment 并 将 其 添加 给 托管 activity。 


同样 的 检查 ，PhotoGalleryActivity 有 不 同 的 处 理 办 法 : 判断 传 
入 onCreate(...) 的 savedInstanceSstatebundle 是 否 为 空 。 我 们 知 
道 ， 如 果 bundle 数 据 为 室 ， 说 明 托 管 activity 刚 启动 ， 不 会 有 fragment 的 
重建 和 再 托管 ， 如 果 bundle 数 据 不 为 空 ， 说 明 托 管 activity 正 在 重建 《〈 设 
备 旋转 或 进程 被 “ 杀 死 "后 ) ， 自 然 它 被“ 杀 死 ”之 前 托管 的 fragment 也 会 
被 重建 和 重新 添加 回来 。 


上 述 两 种 方法 都 有 效 ， 实 际 开 及 中 你 都 会 碰 到 ， 有 其 体 选 哪个 ， 你 自行 决 


Y 


JE 


采用 检查 savedInstanceState 的 方式 ， 你 要 假定 代码 阅读 者 理解 
savedInstanceState 和 fragment 遇 设备 配置 改变 后 重建 的 工作 原理 。 


如 果 是 Android 开 发 新 手 ， 调 
FisupportFragmentManager.findFragmentById(R.id.fragment c 
Ju Le AE. T4335. ABETE, PO, BNE LAA as E 
已 有 fragment， 你 还 是 免不了 要 和 fragment 管 理 右 打交道 。 


现在 ， 我 们 来 配置 fragment 视 图 。PhotoGallery 应 用 会 在 RecyclerView 
视图 中 (借助 其 内 置 的 GridLayoutManager) 以 网 格 的 形式 显示 图 


片 。 首 先是 添加 RecyclerView 依 赖 项 。 打 开 app 模 块 下 的 build.gradle 文 
件 ， 添 加 RecyclerView 依 赖 项 ， 如 代码 清单 24-3 所 示 。 完 成 后 记得 同步 
Gradle 文 件 。 


代码 清单 24-3 ”添加 RecyclerView 依 赖 项 (app/build.gradle) 


dependencies { 


implementation 'androidx.constraintlayout:constraintlayout:2.0.0-alpha2 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 


接 下 来 ， 在 项 目 工具 窗口 右键 单 击 reslayout， 选 择 New — Layout 
resource file 创 建 一 个 布局 资源 文件 。 将 这 个 文件 命名 为 
fragment_photo_gallery.xml， 输 入 
androidx.recyclerview.widget.RecyclerView 作 为 Root element。 打 开 新 建 
文件 ， 设 置 RecyclerView 的 android:id 的 属性 值 

为 @+id/photo_recycler_view， 完 成 后 的 内 容 如 代码 清单 24-4 所 示 。 


代码 清单 24-4 ”添加 RecyclerView 视 图 
(res/layout/fragment_photo_gallery.xml ) 


<?xml version-"1.0" encoding-"utf-8"?» 
«androidx.recyclerview.widget.RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 


android: id="@+id/photo_recycler_view" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 


最 后 ， 创 建 PhotoGalleryFragment 类 ， 实 例 化 新 建 布局 并 引 

用 RecyclerView 视 图 。 再 将 GridLayoutManager 设 置 为 RecyclerView 

的 layoutManager。 当 前 ， 先 人 硬 编码 设置 网 格 为 三 列 (24.12 市 会 讨论 

D 。 完 成 后 的 代码 如 代码 清单 24-5 
示 。 


代码 清单 24-5 ”创建 和 配 
置 PhotoGalleryFragment (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoRecyclerView: RecyclerView 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View { 
val view = inflater.inflate(R.layout.fragment photo gallery, contai 


photoRecyclerView = view.findViewById(R.id.photo recycler view) 
photoRecyclerView.layoutManager - GridLayoutManager(context, 3) 


return view 


} 


companion object { 
fun newInstance() = PhotoGalleryFragment() 


} 


继续 学 习 之 前 ， 试 着 运行 PhotoGallery 应 用 。 如 果 一 切 正 常 ， 可 以 看 到 
一 个 空白 视图 。 


24.2 ”Retrofit 网 络 连 接 基 本 


Retrofit 是 由 Square 公 司 创 建 和 维护 的 一 个 开源 库 。 但 本 质 上 ， 它 的 
HTTP 客 户 端 封装 使 用 的 是 OkHttp 库 。 


Retrofit 可 以 用 来 创建 HTTP 网 关 类 。 给 Retrofit 一 个 带 注解 方法 的 接口 ， 
它 会 帮 你 做 接口 实现 。Retrofit 的 接口 实现 能 发 起 HTTP 请 求 ， 收 到 HTTP 
响应 数据 后 能 解析 为 一 个 OkHttp.ResponseBody。 然 

而 ，OkHttp.ResponseBody 无 法 直接 使 用 : 你 要 将 其 转换 为 自己 应 用 
需要 的 数据 类 型 。 为 解决 这 个 问题 ， 可 以 注册 一 个 啊 应 数据 转换 器 。 随 
后 ， 在 准备 网 络 请 求 需 要 的 数据 以 及 从 网 络 啊 应 解析 数据 时 ，Retrofit 束 
可 以 用 这 个 转换 器 进行 各 种 数据 类 型 的 相互 转换 了 。 


在 build.gradle 文 件 中 ， 添 加 Retrofit 依 赖 ， 如 代码 清单 24-6 所 示 。 完 成 
后 ， 记 得 同步 Gradle 文 件 。 


代码 清单 24-6 ”添加 Retrofit 依 赖 Capp/build.gradle) 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 


implementation 'com.squareup.retrofit2:retrofit:2.5.0' 


} 


Flickr REST API 交 互 之 前 ， 先 来 配置 Retrofit 抓 取 并 显示 URL 网 页 内 容 
(Flickr 主 页 ) 。 使 用 Retrofit 要 配置 很 多 东西 。 从 简单 处 入 手 ， 就 是 先 

抓 住 基本 。 稍 后 ， 我 们 会 在 此 基础 上 构建 Flickr 请 求 ， 以 及 反 序 列 化 解 

Lm 应 数据 一 把 序列 化 数据 转化 为 应 用 模型 层 需要 的 非 序 列 化 


24.2.1 定义 Retrofit API 接 口 


是 时 候 着 手 定 义 PhotoGallery 应 用 需要 的 API 了 。 首 先 ， 创 建 一 个 存放 
API 类 代码 的 新 包 。 在 项 目 工具 窗口 ， 碳 键 单 击 
com.bignerdranch.android.photogallery， 选 择 New > Package 荣 单项 。 命 
名 这 个 新 包 为 api。 


接 下 来 ， 在 api 新 包 里 添加 一 个 Retrofit API 接 口 ， 也 就 是 使 用 Retrofit 注 
解 的 标准 Kotlin 接 口 。 在 项 目 工具 窗口 右键 单 击 api 文 件 末 ， 选 择 New 5 
Kotlin File/Class 菜 单项 ，kind 下 拉 框 类 型 保持 File 不 变 ， 创 建 一 个 名 为 
FlickrApi 的 文件 。 如 代码 清单 24-7 所 示 ， 在 FlickrApi.kt 文 件 中 ， 定 义 一 
个 名 为 FlickrApi 的 接口 ， 再 添加 一 个 代表 GET 请 求 的 函数 。 


代码 清单 24-7 添加 Retrofit API 接 口 (app/FlickrApi.kt) 


interface FlickrApi { 


@GET("/") 
fun fetchContents(): Call<String> 


} 
如 果 需 要 导入 Call， 记 得 选择 retrofit2.Call。 
新 接口 里 的 每 一 个 函数 都 对 应 着 一 个 特定 的 HITP 请 求 ， 必 须 使 用 


HTTP 请 求 方法 注解 。 其 作用 是 告诉 Retrofit，API 接 口 定 义 的 各 个 函数 
映射 的 是 哪 一 个 HTTP 请 求 类 型 (又 叫 HTTP 动 词 )。 一 些 常见 的 HTTP 


ip ok AL A@GET. @POST. @PUT. @DELETE#II@HEAD. 


LIAS, @GET("/" HE AEH VES ete fetchContents () ea ZR [BL AY 
Cal1 配 置 成 一 个 GET 请 求 。 字 符 串 "人 /表示 一 个 相对 路 径 URL 针对 
Flickr API 疹 点 基 URL 来 说 的 相对 路 径 。 大 多 数 HTTP 请 求 方法 注解 包括 
相对 路 径 。 这 里 ，"/" 相对 路 径 是 指 请 求 会 发 往 你 稍 后 就 会 提供 的 基 
URL. 


所 有 Retrofit 网 络 请 求 默认 都 会 返回 一 个 retrofit2.Cal1 对 象 〈 一 个 可 
执行 的 网 络 请 求 ) 。 执 行 CalL1 网 络 请 求 就 会 返回 一 个 相应 的 HTTP 网 络 
响应 。 (也 可 以 配置 Retrofit 返 回 RxJava Observable， 但 这 超出 本 书 讨 
论 范畴 。 ) 


Call 的 泛 型 参数 是 什么 类 型 ，Retrofit 在 反 序列 化 HTTP 啊 应 数据 后 束 会 
生成 同样 的 数据 类 型 。Retrofit 默 认 会 把 HTTP 啊 应 数据 反 序列 化 为 一 
个 OkHttp .ResponseBody 对 象 。 指 定 Cal1<String> 就 是 告诉 Retrotfit， 
你 需要 的 是 String 对 象 ， 而 不 是 OkHttp.ResponseBody 对 象 。 


24.2.2 ”构建 Retrofit 对 象 并 创建 API 实 例 


Retrofit 实 例 负 责 实现 和 创建 你 的 API 接 口 实例 。 为 基于 定义 的 API 接 口 
生成 网 络 请 求 ， 你 需要 Retrofit 实 现 并 实例 化 你 的 FlickrAPi 接 口 。 


首先 ， 构 建 并 配置 一 个 Retrofit 实 例 。 打 开 PhotoGalleryFragment.kt 文 
件 ， 在 onCreate(...) 函 数 里 ， 先 构建 一 个 Retrofit 对 象 ， 然 后 用 它 创 
建 并 实现 你 的 FlickrAPi 接 口 ， 如 代码 清单 24-8 所 示 。 


代码 清单 24-8 ”使 用 Retrofit 对 象 创建 API 实 例 
( PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() ( 


private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate(savedInstanceState) 


val retrofit: Retrofit - Retrofit.Builder() 
.baseUrl("https://www.flickr.com/") 
.build() 


val flickrApi: FlickrApi = retrofit.create(FlickrApi::class.java) 


Retrofit.Builder() 是 一 个 流 接口 ， 可 用 来 方便 地 配置 并 构建 Retrotfit 
实例 。 然 后 ， 使 用 baseUr1(.. .) 函 数 提供 要 访问 的 基 URL 端 点 ， 即 


Flickr 主 页 。 这 里 要 注意 两 个 可 能 的 遗漏 点 : 一 个 是 访问 URL 的 https:// 协 
议 ， 一 个 是 UREL 后 面 的 /相对 路 径 〈 保 证 Retrotfit 能 正确 附加 API 接 口 里 提 
供 的 相对 路 径 到 基 URL 上) . 


使 用 Retrofit.Builder() 对 象 进行 参数 设 定 ， 然 后 调用 build() 函 数 
会 返回 一 个 配置 好 的 Retrofit 实 例 。 有 了 Retrofit 实 例 之 后 ， 就 可 以 用 它 
来 创建 你 的 API 接 口 实 例 了 。 注 意 ，Retrofit 在 编译 时 不 会 生成 任何 代码 
一 一 相反 ， 它 会 在 运行 时 做 这 些 事 。 在 你 调用 retrofit.create(...) 
时 ， 合 并 使 用 你 的 API 接 口中 的 信息 以 及 构建 Retrofit 实 例 时 指定 的 信 
尽 ，Retrofit 会 创建 并 实例 化 一 个 匿名 类 在 运行 时 实现 你 的 API 接 口 。 


添加 String 类 型 转换 右 


之 前 说 过 ，Retrofit 默 认 会 把 网 络 啊 应 数据 反 序 列 化 

为 OkHttp3.ResponseBody 对 象 。 但 要 输出 网 页 内 容 日 志 ， 处 理 字 符 串 
类 型 数据 会 更 方便 。 要 让 Retrofit 把 网 络 响 应 数据 反 序列 化 为 String 类 
型 ， 构 建 Retrofit 对 象 时 就 要 指定 一 个 数据 类 型 转换 器 。 

数据 类 型 转换 器 知道 如 何 把 ResponseBody 对 象 解码 为 其 他 对 象 类 型 。 
你 可 以 自 定义 数据 类 型 转换 器 ， 但 这 里 不 需要 。Square 提 供 了 一 个 名 为 
scalars converter 的 开源 数据 类 型 转换 器 ， 你 可 以 用 和 它 把 Flickr 网 站 返回 的 
网 络 啊 应 数据 反 序列 化 为 String 对 象 数据 。 


要 使 用 scalars converter， 首 先 要 在 应 用 模块 的 build.gradle 文 件 里 添加 依 
ee 如 代码 清单 24-9 所 示 。 同 样 ， 添 加 完成 后 ， 记 得 同步 Gradle 文 


代码 清单 24-9 ”添加 scalars converter{K #i (app/build.gradle ) 


dependencies { 


implementation 'com.squareup.retrofit2:retrofit:2.5.0' 
implementation 'com.squareup.retrofit2:converter-scalars:2.5.0' 


现在 ， 如 代码 清单 24-10 所 示 ， 创 建 一 个 scalars converter 实 例 ， 然 后 把 它 
添加 给 Retrofit 对 象 。 


代码 清单 24-10 ”给 Retrofit 对 象 添加 scalars converter 实 例 
( PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() ( 


private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate(savedInstanceState) 


val retrofit: Retrofit - Retrofit.Builder() 
.baseUrl("https://www.flickr.com/") 
.addConverterFactory(ScalarsConverterFactory.create()) 
.build() 


val flickrApi: FlickrApi = retrofit.create(FlickrApi::class.java) 


Retrofit.Builder 的 addConverterFactory(...) 函 数 需要 一 

个 Converter .Factory 实 例 。 数 据 类 型 转换 器 工厂 知道 如 何 创建 并 返 
回 一 个 特定 的 数据 类 型 转换 器 实 

例 。ScalarsConverterFactory.create() 首 先 返 回 一 个 scalars 

converter L) 实例 
(retrofit2.converter.scalars.ScalarsConverterFactory) , 

然后 这 个 工厂 实例 会 向 Retrofit 按 需 提 供 一 个 scalars converter 实 例 。 


具体 来 讲 ， 既 然 你 指定 call<String> 作 

为 FlickrApi.fetchContents() 函 数 的 返回 类 型 ，scalars converter T. 
三 就 会 提供 一 个 字符 串 数据 转换 器 实例 
(retrofit2.converter.scalars.StringResponseBodyConverter 
随后 ， 在 返回 Call 结 果 之 前 ，Retrofit 对 象 就 会 使 用 这 个 字符 串 数据 转 
换 器 把 ResponseBody 对 象 转换 为 String 对 象 。 


Square 还 为 Retrofit 提 供 了 其 他 一 些 开 源 数 据 类 型 转换 器 。 稍 后 ， 我 们 还 
会 使 用 Gson 数 据 类 型 转换 器 。 


24.2.3 ”执行 网 络 请 求 
之 前 ， 我 们 一 直 在 配置 网 络 请 求 。 现 在 ， 期 待 已 久 的 时 刻 终 于 到 了 : fA 
行 网 络 请 求 并 输出 返回 结果 。 首 先 ， 调 用 fetchContents() 函 数 生成 


一 个 代表 可 执行 网 络 请 求 的 retrofit2.Call 对 象 ， 如 代码 清单 24-11 所 
示 。 


代码 清单 24-11 创建 一 个 Cal1 请 求 〈PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoRecyclerView: RecyclerView 
override fun onCreate(savedInstanceState: Bundle?) { 
val flickrApi: FlickrApi = retrofit.create(FlickrApi::class. java) 


val flickrHomePageRequest: Call<String> = flickrApi.fetchContents() 


注意 ， 调 用 FlickrApi 的 fetchContents() 函 数 并 不 是 执行 网 络 请 求 ， 
而 是 返回 一 个 代表 网 络 请 求 的 call<String> 对 象 。 然 后 ， 由 你 决定 何 
时 执行 这 个 Call 对 象 。 基 于 你 创建 的 API 接 口 CFlickrApi) 和 Retrofit 
对 象 ，Retrofit 决 定 Call 对 象 的 内 部 细节 。 


为 了 执行 代表 网 络 请 求 的 Ccall 对 象 ， 

在 onCreate(savedInstanceState: Bundle? ) 里 调用 enqueue(...) 
函数 ， 并 传 入 一 个 retrofit2.Callback 实 例 。 另 外 ， 再 添加 一 个 TAG 
常量 方便 后 面 查看 日 志 。 如 代码 清单 24-12 所 示 。 


代码 清单 24-12 ”异步 执行 网 络 请 求 CPhotoGalleryFragment.kt ) 


private const val TAG = "PhotoGalleryFragment" 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoRecyclerView: RecyclerView 
override fun onCreate(savedInstanceState: Bundle?) ( 
val flickrHomePageRequest: Call«String» - flickrApi.fetchContents() 


flickrHomePageRequest.enqueue(object : Callback<String> { 
override fun onFailure(call: Call«String», t: Throwable) { 
Log.e(TAG, "Failed to fetch photos", t) 
} 


override fun onResponse( 
call: Call<String>, 
response: Response<String> 


) { 
Log.d(TAG, "Response received: ${response.body()}") 
j 


J) 


Retrofit 天 生 束 遵循 两 个 最 重要 的 Android 多 线程 规则 。 
(1) 仅 在 后 台 线 程 上 执行 耗 时 任务 。 
(2) 仅 在 主线 程 上 做 UI 更 新 操作 。 


Call.enqueue(... ) 函 数 执行 代表 网 络 请 求 的 Cal1 对 象 。 最 关键 的 
是 ， 它 是 在 后 台 线程 上 执行 网 络 请 求 的 。 这 一 切 都 由 Retrofit 管 理 和 调 
度 ， 你 完全 不 用 操心 。 


线程 管理 着 一 个 工作 任务 队列 。 调 用 Call.enqueue(...) 函 数 ， 就 是 
让 Retrofit 把 你 的 网 络 请 求 任 务 放 入 它 的 工作 任务 队列 里 。 你 可 以 一 次 添 
加 多 个 工作 任务 ， 让 Retrofit 顺 序 执行 它们 ， 直 到 清空 任务 队列 。 (第 25 
章 将 讨论 创建 和 管理 后 台 线 程 。) 


网 络 请 求 执行 完毕 且 网 络 啊 应 回 传 之 后 发 生 的 事情 由 传递 给 
enqueue(. . .) 函 数 的 Callback 对 象 决 定 。 网 络 请 求 在 后 台 线 程 上 完成 
后 ，Retrofit 会 根据 不 同情 况 调 用 主线 程 上 的 不 同 回调 函数 : 如 果 网 络 啊 
应 数据 来 自 网 络 服务 器 ， 就 调用 callback. onResponse(...) 函 A, 8 
Wl), atv HeCallback.onFailure(...) RŽ. 


Retrofit 传 递 给 onResponse(...) 函 数 的 Response 体 里 就 是 网 络 返 回 结 
果 内 容 。 结 果 数 据 类 型 和 你 在 API 接 口 里 指定 的 数据 类 型 一 致 。 这 

里 ，fetchContents() 返 回 的 是 Call<Sstring>， 因 此 
response.body() 返 回 的 是 string 类 型 数据 。 


传递 给 onResponse() 和 onFailure() 函 数 的 Cal1 对 象 就 是 最 初 发 起 网 
络 请 求 的 Call 对 象 。 


你 可 以 调用 Call .execute() 函 数 并 友 执 行 网 络 请 求 ， 但 要 保证 网 络 请 
求 运行 在 后 台 线 程 上 ， 而 不 是 主 UI 线 程 上 。 由 第 11 章 可 知 ，Android 不 
允许 在 主线 程 上 执行 网 络 请 求 这 样 的 耗 时 任务 。 如 果 强 行为 之 ， 
Android 会 抛 出 NetworkOnMainThreadException 异 常 。 


24.2.4 获取 网 络 使 用 权限 


要 连接 网 络 ， 还 需 完 成 一 件 事 : 取得 使 用 网 络 的 权限 。 正 如 用 户 怕 被 偷 
担 一 样 ， 他 们 也 不 想 应 用 耗费 流量 偷偷 下 载 图 片 。 


要 取得 网 络 使 用 权限 ， 先 要 在 manifests/AndroidManifest.xml 文 件 中 添加 
它 ， 如 代码 清单 24-13 所 示 。 


代码 清单 24-13 ”在 配置 文件 中 添加 网 络 使 用 权限 


(manifests/AndroidManifest.xml ) 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="com.bignerdranch.android.photogallery" > 


«uses-permission android:name="android.permission. INTERNET" /> 


<application> 


</application> 


</manifest> 


如 今 ， 大 部 分 应 用 需要 联网 ， 因 此 ，Android 视 INTERNET 权 限 为 非 危 险 
性 权限 。 这 样 一 来 ， 只 要 在 manifest 文 件 里 做 个 声明 ， 就 可 以 直接 使 用 
它 了 。 而 有 些 危 险 性 权限 (比如 获取 设备 地 理 位 置 权 限 ) ， 既 需要 声明 
又 需要 在 应 用 运行 时 动态 申请 。 


运行 PhotoGallery 应 用 。 如 图 24-3 所 示 ， 你 应 该 能 看 到 Flickr 主 页 的 
HTML 代 码 塞 满 了 Logcat 窗 口 。 (LogCat 窗 口中 各 类 信息 混杂 ， 为 方便 
查找 ， 可 使 用 TAG 第 量 过 滤 日 志 输 出 。 这 里 ， 在 日 志 搜索 框 里 ， 你 可 以 
输入 PhotoGalleryFragment 关 键 字 。 ) 


Logcat vL 
if Emulator Pixel 2 APL 28 $ combignerdranch antro pif] Verbose BO protoGaleryiragment E) Regex No Filters 


2018-12-18 15:55:21,784 17382-17382/com, bignerdranch, android, photogallery D/PhotoGalleryFraonent; Response received: <!DOCTYPE html» 
: «htl xnlnsscc="httor//creativeconnons, ora/ns#" Vangz"en-us" class="no=js fluid html-sohp-slideshow-view is-hanukkah=day scrolling-layout "> 
<head> 

«neta property="fbsapp_id" content="137206539707334" /> 

«neta property="og:site nane" content="Flickr" /> 

«neta propertyz"og:updated, tine" content="201~12-10720;55; 22,4052" /> 


«neta nates" robots" contents" archive" /> 
«neta nane="googlebot" contente" archive" /> 


j 
K 
t 
M 
è 
G 


<script types" anplication/ dij son» 
( 


"acontext": "htto: //schema oro", 


图 24-3 Logcat 中 的 Flickr.com 网 页 


24.2.5 ”使 用 仓库 模式 联网 


当前 ， 应 用 的 联网 代码 都 写 在 fragment 里 。 继 续 学 习 之 前 ， 先 把 Retrofit 
配置 代码 和 API 联 网 代码 转移 到 一 个 新 类 里 。 


创建 一 个 名 为 FlickrFetchr.kt 的 新 Kotlin 文 件 。 首 先 ， 添 加 一 个 属性 保 
存 FlickrApi 实 例 。 然 后 ， 从 PhotoGalleryFragment 里 把 Retrofit 配 置 
代码 和 API 接 口 实例 化 代码 复制 到 新 类 的 init 初 始 化 代码 块 里 ， 再 把 原 
来 flickrApi 的 声明 和 赋值 语句 拆 分 为 两 行 ， 即 把 flickrApi 声 明 

为 FlickrFetchr 类 的 私有 属性 一 一 不 让 外 部 类 引用 到 它 。 


处 理 完毕 ，FlickrFetchr 类 的 代码 应 如 代码 清单 24-14 所 示 。 


代码 清单 24-14 创建 FlickrFetchr (FlickrFetchr.kt) 


private const val TAG = "FlickrFetchr" 


class FlickrFetchr { 


private val flickrApi: FlickrApi 


init { 
val retrofit: Retrofit = Retrofit.Builder() 
.baseUrl("https://www.flickr.com/") 
.addConverterFactory(ScalarsConverterFactory.create()) 
.build() 


flickrApi = retrofit.create(FlickrApi::class.java) 


回 到 PhotoGalleryFragment， 删 除 见 余 的 Retrofit 配 置 代码 ， 如 代码 清 
单 24-15 所 示 。 这 时 ， 你 会 发 现代 码 里 有 错误 提示 。 暂 时 忽略 ， 稍 
ÓnFlickrFetchr/4V R3 sc Amey T - 


代码 清单 24-15 ”删除 Retrofit 配 置 代码 (PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


— —baseUrl(C"https-77www-flickr-com/-- 
—— ——f,addCenverterFactery(ScalaPsConverterFactobPy-createQ) 


val flickrHomePageRequest : Call<String> = flickrApi.fetchContents( 


接 下 来 ， 向 FLickrFetchr 里 添加 一 个 名 为 fetchContents() 的 函数 ， 
封装 抓 取 Flickr 主 页 内 容 的 Retrofit API 函 数 。〔 大 部 分 代码 可 以 从 
PhotoGalleryFragment 复 制 过 来 ， 再 做 必要 调整 ， 最 后 的 结果 如 代码 
清单 24-16 所 示 。 ) 


代码 清单 24-16 ”添加 fetchContents() 函 数 (FlickrFetchr.kt) 


private const val TAG = "FlickrFetchr" 


class FlickrFetchr ( 
private val flickrApi: FlickrApi 
init { 
s 


fun fetchContents(): LiveData«String» { 
val responseLiveData: MutableLiveData<String> = MutableLiveData() 
val flickrRequest: Call«String» - flickrApi.fetchContents() 


flickrRequest.enqueue(object : Callback«String» ( 


override fun onFailure(call: Call«String», t: Throwable) { 
Log.e(TAG, "Failed to fetch photos", t) 
} 


override fun onResponse( 
call: Call<String>, 
response: Response<String> 
) { 
Log.d(TAG, "Response received") 
responseLiveData.value = response.body() 


}) 


return responseLiveData 


} 


fEfetchContents() ria, B ^scmu— 

个 MutableLiveData<String> 空 对 象 并 赋值 给 responseLiveData 变 
量 。 然 后 把 抓 取 Flickr 主 页 的 网 络 请 求 加 入 任务 队列 ， 并 立即 返回 
responseLiveData【《〈 网 络 请 求 执行 完成 之 前 ) 。 接 下 来 ， 在 网 络 请 求 
任务 成 功 结束 后 ， 赋 值 responseLiveData.value 并 发 布 结果 。 通 过 这 
种 方式 ， 其 他 类 如 PhotoGalleryFragment 就 能 观察 

到 fetchContents() 函 数 返 回 的 LiveData， 并 最 终 收 到 网 络 响应 数 
据 。 


注意 ，fetchContents() 函 数 返 回 的 是 个 无 法 修改 的 
LiveData<String>。 可 修改 的 LiveData 对 象 尽 量 不 要 对 外 暴露 ， 以 防 
被 其 他 外 部 代码 算 改 。LiveData 里 的 数据 流动 应 保持 一 个 方向 。 


在 PhotoGallery 应 用 里 ，FlickrFetchr 封 装 了 大 部 分 联网 相关 的 代码 
(现在 只 是 一 小 部 分 ， 接 下 来 的 几 章 会 不 断 扩 

充 ) 。fetchContents() 函 数 把 网 络 请 求 放 入 任务 队列 ， 然 后 把 结果 
封装 在 LiveData 里 。 现 在 ， 应 用 里 的 其 他 组 件 ， 比 如 
PhotoGalleryFragment (或 菜 些 ViewModel、activity 等 ) ， 就 能 直接 
创建 FlickrFetchr 实 例 ， 访 问 网 络 获 得 图 片 数据 了 。 人 至 于 Retrofit 是 什 
么 ， 数 据 从 哪里 来 ， 它 们 完全 不 用 关心 。 


如 代码 清单 24-17 所 示 ， 更 新 PhotoGalleryFragment， 使 
用 FlickrFetchr 体 会 一 下 代码 封装 的 魔力 。 


代码 清单 24-17 在 PhotoGalleryFragment 中 使 
用 FlickrFetchr (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


DU 


val flickrLiveData: LiveData<String> = FlickrFetchr().fetchContents 
flickrLiveData.observe( 
this, 
Observer ( responseString -> 
Log.d(TAG, "Response received: $responseString") 


}) 


刚才 代码 重 构 采用 了 Google 应 用 架构 指导 里 推荐 的 仓库 模式 。 现 

在 ，FlickrFetchr 起 着 基本 仓库 的 作用 。 这 种 仓库 类 封装 了 从 一 个 或 
多 个 数据 源 获 取 数 据 的 逻辑 。 不 管 是 本 地 数据 库 ， 还 是 远程 服务 器 ， 它 
都 知道 该 如 何 获取 或 保存 各 种 数据 。UI 代 码 不 关心 数据 的 获取 和 保存 
(仓库 类 自己 的 内 部 实现 ) ， 需 要 数据 时 ， 找 仓库 类 就 行 了 。 


现在 ， 应 用 的 数据 都 来 自 Flickr 网 络 服务 器 。 不 过 ， 将 来 你 或 许 还 想 把 

数据 缓存 到 本 地 数据 库 里 。 到 那 时 ， 目 然 还 是 由 仓库 负 贡 从 合适 的 地 方 

人 无 须 关 心 数 据 来 目 哪 里 ， 应 用 里 的 其 他 模块 可 以 直接 调用 仓 
读 取 数据 。 


再 次 运行 应 用 。 如 果 没 问题 ， 你 应 该 能 看 到 Logcat 窗 口中 打印 的 Flickr 主 
页 内 容 (图 24-3) 。 


24.3 ”从 Flickr 获 取 JSON 数 据 


JSON (JavaScript Object Notation) 是 近年 流行 开 来 的 一 种 数据 格式 ， 
尤其 适用 于 Web 服 务 。 


Flickr 提 供 了 方便 而 强大 的 JSON API。 可 从 flickr.com/services/api/ 文 档 页 
但 看 使 用 细 市 。 在 常用 浏览 器 中 打开 API 文 档 网 页 ， 找 到 Request 
Formats 列 表 。 我 们 只 打算 使 用 最 简单 的 REST 服 务 。 碍 文档 得 知 ，REST 
的 API 端 点 Cendpoint) 是 api.flickr.comy/services/resVy。 因 此 ， 可 以 在 此 
端点 上 调用 Flickr 提 供 的 方法 。 


回 到 API 文 档 主 页 ， 找 到 API Methods 列 表 。 癌 下 滚动 到 interestingness 区 
域 并 找到 fl1ickr.interestingness.getList 方 法 。 点 击 查看 该 方 
法 。 文 档 对 访 方 法 的 描述 为 : “返回 最 近 上 传 到 flickr 的 有 趣 图 片 。” 这 人 恰 


好 就 是 PhotoGallery 应 用 需要 的 方法 。 


getList 方 法 需要 的 唯一 参数 是 一 个 API key。 为 获得 它 ， 回 到 
flickr.com/services/api/ 网 页 ， 找 到 并 点 击 API keys 链 接 进 行 申 请 《〈 需 注册 
登录 ) 。 你 可 以 登录 并 申请 一 个 非 商 业 用 途 API key。 申 请 成 功 后 ， 可 
获得 类 似 4f721bgafa75bf6d2cb9af54f937bb70 这 样 的 API key. (申请 API 
key 时 ， 还 会 得 到 一 个 用 来 访问 特定 用 户 信息 和 图 厂 的 Secret keys X E 
不 需要 ， 忽 略 即 可 。) 


n we key 后 ， 可 直接 向 Flickr 网 络 服务 发 起 一 个 和 下 面 类 似 的 GET 请 


https://api.flickr.com/services/rest/?method=flickr.interestingness.getList 


&api key- yourApiKeyHere &format-json&nojsoncallback-1&extras-url s 


Flickr 默 认 返 回 XML 格 式 的 数据 。 要 获得 有 效 的 JSON 数 据 ， 就 需要 同时 
指定 format 和 noJjsoncallback 参 数 。 设 置 nojsoncallback 为 1 就 是 告 
， 返回 的 数据 不 应 包括 封闭 方法 名 和 括号 。 这 样 才 方便 Kotlin 代 
码 解析 数据 。 


指定 值 为 url_s 的 extras 参 数 是 告诉 Flickr， 如 有 小 尺寸 的 图 片 ， 也 一 
并 提供 它们 的 URL。 


复制 上 述 链接 到 浏览 器 ， 使 用 刚 获取 的 API key 蔡 换 yourApiKeyHere 后 回 
车 。 很 快 ， 就 能 看 到 如 图 24-4 所 示 的 JSON 返 回 数据 。 


€ > © OQ httos://api-flickr.com/services 


{"photos":{"page":1,"pages":470,"perpage":100,"total":"46927", "photo": 

({"dd"s"44569688660", "owner"; "24231108eN08", "secret." :" 3ee8cb884e","server"s"4639","farm':5,"title"s "WWII 
141,B4.F1.1","ispublic":1,"isfriend’s0,"isfamily's0,"url_s"s"httpss\/\/farmS  staticflickr.com\/4839\/44569688660 3ee8cb884e m. jpg", "height s": 
"240" "width_s"s"193"},{"dd"s"L1194024914", "owner"s"12403504@N02", "seoxet"s"91553593ca", "server's "5473","farm's6, "title's "Image taken from 


page 38 of ‘Rambles round Rossendale. (Second 
series,)'","ispublic':1,"isfriend’:0,"isfamily"s0,"url_s"s"httpss\/\/farm6 staticflickr com\/5473\/11194024914 91553593ca m. jpg", "height s'il 


83", "width $^: 240"), {"ad"s"1124570594", "owner" 1124035048802" |" secret i  efüdaa94a0" ," server" 2670" ," farm" i4, title i Image taken from page 


109 of 'The Doctor's 
Dozen" ," ispublic":1, "igfriend":0,  iefanily' 10, "url, 8":"https:\/\/farm4, etatieflickr.com /3670V/ 11124570594 ef8daa94a0_m. jpg" , "height, $'1*55", 


"width 8": 240^), ("121 11273449492" ," ovmer " 112403504802" , "secret" 1  65647016b0" , "server" 1 3711" "farm i4, " title" i" Image taken from page 27 


of 'English Pictures drawn with pen and 
pencil'","ispublic"s1,"isfriend":0,"isfamily':0,"url_s"s"https:\/\/farm4.staticflickr com\/3711\/11273449483 65047016b8 m. jpg", "height, 8":"175 


" "width 8:240"), (1d :*11225189606" |" owner": 124035040802" , " secret" :" ££122a405a" , "server" "1442" ," arn" 18, "title" i" Inage taken from page 


206 of 'A Midnight Mystery. A 
novel'","ispublic"s1,"isfriend"s0,"isfamily's0,"url_s"s"https:\/\/farmé, staticflickr.com\/7442\/11225189606_f£122a485a_m. jpg", "height_s"s"240" 


"ub AER a'i IRQ!L [647,711244027004". Varmar” "12402804402". Moanvat i'ATIRARCERRT "navega! ITIN! "Famed "kielal"i" Tmana Faban fram nana 296 


图 24-4 JSON 数 据 示 例 


现在 ， 是 时 候 更 新 抓 取 Flickr 主 页 的 联网 代码 ， 转 而 从 Flickr REST API 
获取 最 近 有 意思 的 图 片 了 。 首 先 ， 在 FlickrApi 接 口 里 添加 一 个 函数 。 
同样 ， 这 里 的 yourApiKeyHere 要 蔡 换 成 你 自己 的 API Key。 现 在 ， 先 在 
相对 路 径 字 符 串 里 硬 编 码 URL 碍 询 参数 。 〈 稍 后 ， 我 们 会 把 这 些 奋 询 参 
数 抽取 出 来 ， 以 代码 的 方式 拼接 。) 如 代码 清单 24-18 所 示 。 


代码 清单 24-18 定义 获取 图 瞩 的 网 络 请 求 Capi/FlickrApi.kt) 


interface FlickrApi { 


QGET( 
"services/rest/?method-flickr.interestingness.getlist" + 
"&api keyzyourApiKeyHere" + 
"&format-json" + 
"&nojsoncallback-1" + 
"&extras-url s" 


) 
fun fetchPhotos(): Call<String> 


} 


注意 ， 这 里 我 们 赋值 的 参数 
有 method、api key、format、nojsoncallback 和 和 extras。 


接 下 来 ， 更 新 FlickrFetchr 里 的 Retrofit 实 例 配 置 代码 。 把 基 URL 从 
Flickr 主 页 改 为 基 API 端 点 ， 再 把 fetchContents() 函 数 改 名 

为 fetchPhotos()， 并 在 API 接 口上 调用 新 的 fetchPhotos() 函 数 。 如 
代码 清单 24-19 所 示 。 


代码 清单 24-19 更 新 基 URL (FlickrFetchr.kt) 


class FlickrFetchr ( 
private val flickrApi: FlickrApi 


init { 
val retrofit: Retrofit - Retrofit.Builder() 
.baseUrl("https:// 


— Www 

——api.flickr.com/") 
.addConverterFactory(ScalarsConverterFactory.create()) 
.build() 


flickrApi = retrofit.create(FlickrApi::class.java) 


——fetchPhotos(): LiveData«String» ( 
val responseLiveData: MutableLiveData<String> = MutableLiveData() 
val flickrRequest: Call«String» - flickrApi. 


——fetchPhotos( ) 


j 
j 


注意 ， 你 设置 的 基 URL 是 api.flickr.com， 但 实际 要 访问 的 是 


api.flickr.com/services/rest。 这 没 问题 ， 因 为 在 FlickrApi 的 @GET 注 解 
里 ， 你 已 经 指定 了 services 和 rest 部 分 。 在 发 出 网 络 请 求 之 前 ，Retrofit 会 
把 包括 在 @GET 注 解 里 的 路 径 和 其 他 信息 附加 到 基 URL 上。 


最 后 ， 更 新 PhotoGalleryFragment 类 文件 ， 不 再 抓 取 Flickr 的 主页 内 
容 ， 转 而 调用 fetchPhotos() 新 函数 去 获取 最 新 的 有 趣 图 片 。 和 之 前 一 
样 ， 当 前 的 序列 化 返回 内 容 为 String 数 据 。 如 代码 清单 24-20 所 示 。 


代码 清单 24-20 调用 fetchPhotos () r& Xt 
( PhotoGalleryFragment.kt ) 
class PhotoGalleryFragment : Fragment() ( 
private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


val flickrLiveData: LiveData«String» = FlickrFetchr().fetch 


———Centents 
—Photos() 


} 


运行 PhotoGallery 应 用 。 可 看 到 LogCat 窗 口中 的 Flickr JSON 数 据 ， 如 图 
24-5 所 示 。 “〈 在 LogCat 搜 索 框 中 输入 PhotoGalleryFragment 可 以 方便 得 
找 o ) 


$ Logeat Hb 
N 


V Emulator HET: combignerdranch android pif] Verbose Q” PhotoGalleryFragment ) Regex No Filters 


!6 1018-12-18 16:14:06,031 10030-10038/con, bignerdranch, android, photogallery D/PhotoGalleryfragnent; Response received: ("photos": ("page":1, "pages": 10 "perpage": 100, "total": 1000, 
H "photo": [("10": "31433289907" "owner" "1444292580806" secret" 66090053" server" 4959", "farm":5, "title": 2018-12-18, 2109,04, UTC, jpg", "ispublic''s1,"isfriend'':0,"isfamily"s0, 
à M Suns https: V V/farrb, staticf Vickr, com /4859\/31433268807_ff6cd9ca53_n, jpg", "height $1240" "width, $1240"), (101 "31433289957" "owner" 137591048807" ," secreti" 55320ecab/", 
2 "server"s'4860","farn''s5,"title's"The Alcohol Epidenic Anongst College Students", "ispublic's1,"isfriend"s0,"isfamily"s6}, (d: 333290047" "owner": " 1596077090802", 
i "secret": "1 47ede55b7" "server"; 4949" "farg":5, "title": "Our Favorite Patch Pets Of 2018 - httpss\/\/t.co\/CqV2Ex2qEA https: Vt, co\/rpPhHkALOw", "ispubtic":1,"isfriend":0, 

^^ ^ ity" O}, 010"; 21423290467" "owner" 1441550280805" " secret" ecd 977374" "server" 41814" "form" i5, "title" "ipu ic" 1," isfriend" 6, "js foni ly": 0, "url s s https: VM farró 
Use Soft Wraps cf lickr, con /4814\/31433290467_ecdfa77374_, jpo", "height, $1180" ,"vidth, $":" 240"), {"id":"31433292327" , "owner" s"55774467@002", "secret": "069997b492" "server" 4997" "farm" :5, 


$$ ut^ "USF, 12-16-18, TLCE-9, CMLO3527, jpg", "ispublic's1,"isfriend!'s0,"isfanily's0,"url_s"s"httpss\/\/famnd,staticf lickr, com\/4897\/31433292327_2609970492_m, jpg" "height, $1" 160", 
1 "width 5", 240"), (10": 31433295067" "owner: "141409070805" "secret" :"f962e7eee3" "server" "4932" "farm":5, "ttl": 2018-12-18, 04-12-40" ,"ispublic":1,"isfriend":0,"isfanily":0, 
$ "url s*ynttpss\/\/tarns, staticf lickr, con\/4832\/31433295067 fü6207ee03 M, jog" "height s":"100","width_s":"240"}, ("1d":"31433296667", "onner'":"96536696@000", "secret": "9c4f8e900f", 
i "server":"4871" ,"farn's5,"title's"Bibliophite', "ispubtic":1,"isfriend":0,"isfamily":0, "url ht 的， 
NG "width_s"'s"240"), {"id":"31433297747" "putet": " 49561324803" ," secret"! bfeb73332c" "server" "4999" "fart:5, "title" "Nachricht vom Rand des Sonnensystems" ,"ispubtic":1,"istriend":0, 
* visfanily":0, "url s"i"https: V V/farnS, stat icf iekr, con /4989 31433297747. bfeb3332c, f. jpg", "heioht, $"1"157" ,"vidth, s": 240"), ("d": "31433298857" "owner" 157239108805" , 

"secret": "4071101421" "server": 4962" "farm":5, "title"; "Record bv Alwavs E-mail [Imaael, 2016-01-06 13:50:30", "isoubtic":1,"isfriend":0,"isfanity":0, "url s"; httos; V Vfarrb 
iR "21000 有 EL Profiler | Build fj Terminal (.] Event Log 


图 24-5 Flickr JSON 数 据 


(LogCat 有 时 不 好 “伺候 ”。 假 如 看 不 到 类 似 图 24-5 的 结果 ， 也 不 用 担 
心 。 模 拟 器 连接 有 时 不 够 稳定 ， 可 能 无 法 及 时 显示 日 志 内 容 。 通 常 ， 它 
能 上 自己 恢复 。 实 在 不 行 ， 请 重启 应 用 或 重启 模拟 器 。) 


本 书 撰写 时 ，Android Studio 的 LogCat 和 窗口 还 无 法 换行 显示 。 想 查看 
JSON 字 符 串 完整 内 容 ， 需 同 右 深 动 窗口 。 或 者 通过 点 击 如 图 24-5 所 示 
的 Use Soft Wraps 按 钮 包装 Logcat 内 容 。 


成 功 取 得 Flickr JSON 返 回 结 果 后 ， 该 如 何 使 用 呢 ?” 和 处 理 其 他 数据 一 
样 ， 将 其 存 入 一 个 或 多 个 模型 对 象 中 。 我 们 马上 要 为 PhotoGallery 应 用 
创建 的 模型 类 名 为 GalleryItem。 它 主要 用 来 保存 图 片 的 一 些 属性 信 
A: 图 片 title、 图 片 ID 和 图片 的 来 源 URL。 

创建 GalleryItem 数 据 类 并 添加 下 列 代 码 ， 如 代码 清单 24-21 所 示 。 


代码 清单 24-21 创建 模型 对 象 类 (GalleryItem.kt) 


data class GalleryItem( 


var title: String = "", 


var id: String = "", 


var url: String = 


SE BURA ER ARN BE JA, Be BORA TES whi ze SE A ISON KEAT BGG o 


反 序 列 化 JSON 数 据 


浏览 器 和 LogCat 中 显示 的 JSON 数 据 难以 阅读 。 如 果 用 空格 回 车 符 格 式 
化 后 再 打印 出 来 ， 结 果 大 致 如 图 24-6 所 示 。 


"photos"; { 


"page": 1, 
"pages": 10, 
"perpage": 100, 
"total": 1000, 
"photo": [ 


JSON text 


{ 
"id"; "9452133594", 


"owner": 444943728805", 


"secret"; "dod20af03e", 
"server"; "7365", 


"farm's 8, 


JSON objects 


JSONObect 


{ Stat, photos } 


“photos” 


JSONObject 


{ page, pages, 
4 Photo } 


Model objects 


FlickrResponse 


photos: PhotoResponse 


PhotoResponse 
galleryltems: 
List<Galleryltem> 


"title": "Low and Wisoff at Work", 
"ispublic": 1, 

"isfriend": 0, 

"{s-family": 0, 

"url s^ "https: //farng, staticflickr, com/u" 


"id": "16317817559", 

"owner": "444943720N05", 

"secret": "137d97804f", 

"server": "8683", 

"farn": 9, 

"title": "Challenger as seen from SPAS", 


Galleryltem 


] 


"ispublic™; 1, 
"jsfriend: 0, 
"isfamily": 0, 


"url s": "https: //farm9, staticflickr con/.." 


"istat" ' "ok 


JSONOhjec! 
(id, owner, ..., 
ttle, ..., url s) 


ld: String 
ttle: String 
url: String 


图 24-6 ”格式 化 后 的 JSON 数 据 


JSON 对 象 是 一 系列 包含 在 { } 中 的 名 值 对 。JSON 数 组 是 包含 在 [ ] 中 用 
逗号 隔 开 的 JSON 对 象 列 表 。 对 象 彼此 内 套 形成 层级 关系 。 


Android 提 供 了 标准 org.json 包 ， 里 面 有 一 些 类 可 以 直接 创建 和 解析 JSON 
数据 (比如 JSONObject 和 JSONArray) 。 不 过 ， 一些 聪 明 的 开发 人 员 
己 创建 了 不 少 JSON 库 ， 可 以 把 JSON 文 本 和 Java 对 象 互 相 转 换 。 


Gson 就 是 这 样 的 一 个 库 。Gson 可 以 帮 你 自动 把 JSON 数 据 解析 为 Kotlin 对 
象 。 这 样 一 来 ， 你 就 不 用 编写 任何 JSON 数 据 解析 代码 了 。 你 要 做 的 只 
是 定义 Kotlin 类 和 JSON 对 象 结构 之 间 的 映射 关系 ， 其 余 的 区 给 Gson 处 理 
WE T o 
Square 专门 为 Retrofit 定 制 了 Gson 数 据 转换 堪 。 要 使 用 Gson 和 Retrofit 
Gson 数 据 转换 库 ， 你 需要 在 应 用 模块 下 的 Gradle 文 件 里 添加 它们 的 库 依 
赖 ， 如 代码 清单 24-22 所 示 。 同 样 ， 添 加 完成 后 ， 记 得 同步 Gradle 文 件 。 
代码 清单 24-22 ”添加 Gson 依 赖 项 Capp/build.gradle ) 


dependencies { 


implementation 'com.squareup.retrofit2:retrofit:2.5.0' 


implementation 'com.squareup.retrofit2:converter-scalars:2.5.0' 
implementation 'com.google.code.gson:gson:2.8.5' 
implementation 'com.squareup.retrofit2:converter-gson:2.4.0' 


接 下 来 是 在 Flickr 网 络 响应 里 创建 映射 JSON 数 据 的 模型 对 象 。 之 前 创建 
的 GalleryItem 模 型 类 几乎 可 以 直接 和 图 片 JSON 数 组 里 的 对 象 匹 配 。 
Gson 默 认 支 持 JSON 对 象 名 和 属性 名 一 一 匹配 。 也 就 是 说 ， 如 果 你 的 属 
性 名 和 JSON 对 象 名 相 匹 配 ， 那 就 可 以 直接 用 了 。 


不 过 ， 属 性 名 也 不 是 一 定 要 和 JSON 对 象 名 完全 一 样 。 对 比 
GalleryItem.ur1l 属 性 和 JSON 数 据 里 的 "url_s" 字 段 可 

知 ，GalleryItem.ur1 在 代码 上 下 文 里 表意 更 直 白 ， 所 以 应 该 保持 不 
变 。 这 种 情况 下 ， 可 以 给 它 添 加 一 个 @SerializedName 注 解 ， 让 Gson 知 
道 GalleryItem.url 属 性 是 和 哪 一 个 JSON 字 段 相对 应 的 。 


如 代码 清单 24-23 所 示 ， 更 新 GalleryItem 落 实 以 上 方案 。 
代码 清单 24-23 ”和 履 盖 默认 的 名 称 属性 映射 CGalleryItem.kt) 


data class GalleryItem( 
var title: String = "", 


var id: String = "", 
@SerializedName("url_s") var url: String = "" 


) 


现在 ， 创 建 一 个 PhotoResponse 类 映射 JSON 数 据 里 的 "photos" 对 象 。 
这 个 新 类 也 应 该 放 在 api 包 里 ， 因 为 它 是 反 序 列 化 Flickr API 实 现 用 到 的 
辅助 类 ， 其 映射 的 并 不 是 应 用 要 使 用 的 模型 对 象 数 据 。 


在 这 个 新 类 里 添加 一 个 名 为 galleryItems 的 属性 并 以 
@SerializedName("photo") 注 解 ， 用 来 存储 图 片 集 ， 如 代码 清单 24-24 所 
示 。Gson 会 自动 创建 一 个 List 集 合 ， 并 使 用 JSON 数 组 里 的 图 片 对 象 进行 
填充 。 目 前 ， 只 需 关 心 "photo" JSON 对 象 里 的 图 片 集合 即 可 。 稍 后 ， 
如 果 想 完成 24.10 节 的 挑战 练习 ， 那 么 你 还 得 去 抓 取 分 页 数据 。 


代码 清单 24-24 ”新建 PhotoResponse 类 (PhotoResponse.kt) 


class PhotoResponse { 
@SerializedName("photo") 


lateinit var galleryItems: List<GalleryItem> 


} 


最 后 ， 如 代码 清单 24-25 所 示 ， 在 api 包 里 再 添加 一 个 名 

为 FLickrResponse 的 新 类 。 这 个 类 映射 的 是 JSON 数 据 的 最 外 层 对 象 
(JSON 对 象 树 中 的 顶层 对 象 ， 包 含 在 最 外 层 {} 里 ) 。 再 添加 一 个 属性 
BRE ISON ACHE Hy" photos "Ex. 


代码 清单 24-25 新建 FlickrResponse 类 (FlickrResponse.kt ) 


class FlickrResponse { 
lateinit var photos: PhotoResponse 


} 


图 24-6 给 出 了 以 上 创建 的 对 象 和 JSON 数 据 的 映射 关系 。 


现在 ， 准 备 工作 都 做 好 了 ， 可 以 让 Gson 施 展 魔力 了 : 配置 Retrofit 使 用 
Gson 把 JSON 数 据 反 序 列 化 解析 为 我 们 刚 定 义 的 模型 对 象 。 首 先 ， 更 新 
Retrofit API 接 口 里 的 返回 类 型 和 映射 JSON 最 外 层 对 象 的 自 定 义 模型 对 
象 相 匹 配 。 这 也 是 告诉 Gson， 它 应 该 使 用 FlickrResponse 来 反 序 列 化 
JSON 响 应 数据 ， 如 代码 清单 24-26 所 示 。 


代码 清单 24-26 ”更 新 fetchPhoto() 的 返回 类 型 (FlickrApi.kt) 


interface FlickrApi { 


@GET(...) 
fun fetchPhotos(): Call< 


—FlickrResponse> 


} 


接 下 来 是 更 新 FLlickrFetchr 类 。 首 先 使 用 GsonConverterFactory 蔡 
换 ScalarsConverterFactory。 更 新 fetchPhotos() 返 回 接收 图 片 集 
合 的 LiveData， 即 把 LiveData 和 MutableLiveData 的 类 型 从 String 
改 为 List<GalleryItem>。 同 时 也 把 call 和 Callback 的 String 类 型 
改 为 FlickrResponse。 最 后 ， 更 新 onResponse(...) 消 数 ， 从 返回 数 
据 里 取出 图 片 项 集合 ， 并 赋值 给 LiveData 对 象 ， 如 代码 清单 24-27 所 
示 。 


代码 清单 24-27 为 Gson 更 新 FlickrFetchr (FlickrFetchr.kt) 


class FlickrFetchr { 


private val flickrApi: FlickrApi 


init { 
val retrofit: Retrofit = Retrofit.Builder() 
.baseUrl("https://api.flickr.com/") 
.addConverterFactory( 


——Seatars€enverterFactery 
—GsonConverterFactory.create() ) 
.build() 


flickrApi = retrofit.create(FlickrApi::class.java) 


fun fetchPhotos(): LiveData« 


— —String 
——List«GalleryItem»» { 


val responseLiveData: MutableLiveData<List<GalleryItem>> = MutableL 
val flickrRequest: Call« 


— —String 
——FlickrResponse» - flickrApi.fetchPhotos() 
flickrRequest.enqueue(object : Callback« 
— String 
——FlickrResponse» { 
override fun onFailure(call: Call< 
— String 
——FlickrResponse», t: Throwable) { 
Log.e(TAG, "Failed to fetch photos", t) 


} 
override fun onResponse( 
call: Call« 
— —String 
——FlickrResponse», 
response: Response« 
— —String 
——FlickrResponse» 
) { 
Log.d(TAG, "Response received") 
— —respenseLiveData.value—-—respoense-bedyO) 


val flickrResponse: FlickrResponse? - response.body() 
val photoResponse: PhotoResponse? - flickrResponse?.photos 
var galleryItems: List«GalleryItem» = photoResponse?.galler 
?: mutableListOf() 
galleryItems = galleryItems.filterNot { 
it.url.isBlank() 


} 
responseLiveData.value = galleryItems 
} 
13 


return responseLiveData 


注意 ， 并 不 是 所 有 图 片 都 有 对 应 的 ur1_s 链 接 。 因 此 ， 上 述 代码 要 使 
用 filterNot{ . . .} 过 滤 那 些 融 空 ur1_s 值 的 网 片 。 


最 后 ， 更 新 PhotoGalleryFragment 里 LiveData 的 数据 类 型 ， 如 代码 
清单 24-28 所 示 。 


代码 清单 24-28 ”更 新 PhotoGalleryFragment 里 的 类 型 定义 
(PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 
private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


1 flickeLiveData: LiveData«Stri - FlickeFetehe C) fetehPhetesQ 
val flickrLiveData: LiveData«List«GalleryItem»» - FlickrFetchr().fe 
flickrLiveData.observe( 
this, 
Observer { 


— —respenseString 
——galleryItems -> 
Log.d(TAG, "Response received: $ 


——galleryItems") 
}) 


} 


运行 PhotoGallery 应 用 ， 测 试 JSON 解 析 代 码 。 在 Logcat 窗 口中 ， 你 应 该 
能 看 到 tostring() 函 数 的 图 片 集合 输出 。 如 果 想 进一步 查看 图 片 集合 
里 的 内 容 ， 可 以 在 Observer 里 给 日 志 语句 打上 断 点 ， 再 使 用 调试 器 好 
好 看 看 galleryItems 的 内 容 ， 如 图 24-7 所 示 。 


galleryltems 


v galleryitems = {ArrayList@11711} size = 100 


= 0 = {Galleryltem@11718} "Galleryltem(title=Keel-billed Toucan... View 
[P id = "46505440982" 
f title = "Keel-billed Toucan" 
f url = "https://farm8.staticflickr.com/7905/46505440!... View 
'f shadow$_klass_ = {Class@11344} "class com.bignerdr... Navigate 
'f shadow$_monitor_ = 0 
= 1 = {Galleryitem@11719} "Galleryltem(title=Effraie des clocher... View 
= 2 = {Galleryltem@11720} "Galleryltem(title=Caspian Tern, id=«... View 
= 3 = {Galleryitem@11721} ' haod andy Peanut butter....sc... View 


ES OA | (alae slit aes 11799) t! esllacdltecltitla Llasdcl ec Cun liansas 


图 24-7 Flickr JSON 数 据 


如 果 遭 遇 UninitializedPropertyAccessException 异 常 ， 请 检查 你 
的 网 络 请 求 是 合 已 正确 配置 。 此 外 ， 如 遇 API key 失 效 的 情况 ，Flickr 

API 会 返回 一 个 正常 返回 码 (200) ， 但 响应 数据 为 室 ， 因 此 Gson 将 无 
法 解析 到 任何 有 效 数据 。 


24.4 应 对 设备 配置 改变 


搞定 了 应 用 的 JSON 数 据 解 析 ， 现 在 来 看 看 应 用 是 否 能 正确 应 对 设备 配 
置 改变 。 运 行 PhotoGallery 应 用 ， 确 认 设 备 或 模拟 器 的 自动 旋转 已 经 打 
开 ， 然 后 连续 旋转 设备 几 次 。 输 入 PhotoGalleryFragment 过 滤 日 志 
后 ， 检 查 Logcat 和 窗口 的 日 志 输 出 ， 如 图 24-8 所 示 。 


Logeat b 


à 
i) Emulator Pixel 2. AP| 28 Ü com bignerdranch android pf) Verbose Q PhotoGalleryFragment E) Regex No Filters 


t 1019-01-02 21:54:51,755 20941-20941/con, bignerdranch, android. photogallery D/PhotoGalleryFragnent: Response received: (Galleryltem(titleekeel-billed Toucan, id=46505440982, urlehttps://fi 
2019-01-02 22:03:33,443 21197-21197/con, bignerdranch, android, photogallery D/PhotoGalleryFragnent: Response received: [GallenyIten(titlesKeel-billed Toucan, id=46505440082, urlehttps://fi 
FS 2019-01-02 22:11:01,185 21284-21264/con, bignerdranch, android, photogallery O/PhotoGalteryFragnents Response received: (Galleryltem(titlesKeel-billed Toucan, id=46505440082, urlehttps://fi 
2019-01-02 22:11:49,734 21284-21284/con, bignerdranch, android, photogallery D/PhotoGalleryFragment: Response received: [GalleryIten(titlesKeel-billed Toucan, id=46505440982, urlehttps://fi 
2019-01-02 22:11:53,061 21284-21264/con, bignerdranch, android, photogallery O/PhotoGalleryFragnents Response received: (Gallerylten(titlesKeel-bitled Toucan, id=46505440082, urlehttps://fi 


+ 


Bi Terminal |" Build | Se loge /7 Profler p 4:Run 的 5:Debug > T000 @ Event Log 
图 24-8 多 次 设备 旋转 后 的 Logcat 日 志 输 出 


怎么 回 事 ? 每 次 旋转 设备 ， 应 用 都 会 发 出 一 个 新 的 网 络 请 求 。 原 

来 ，PhotoGalleryFragment 在 设备 旋转 时 都 会 被 销毁 再 重建 ， 结 

在 onCreate(...) 函 数 里 ， 每 次 都 会 重新 发 起 数据 下 载 的 网 络 请 求 。 显 
然 ， 这 是 个 毫 无 必要 的 重复 性 劳动 。 即 便 旋 转 设 备 ， 同 样 的 请 求 及 返回 
数据 都 应 该 保留 下 来 ， 以 保证 良好 的 用 户 使 用 体验 ， 同 时 节约 用 户 的 数 


气流 量 。 


应 用 应 该 在 fragment 首 次 创建 并 出 现在 屏幕 上 时 ， 发 起 一 次 网 络 下 载 请 
求 获 取 图 片 数 据 。 然 后 ， 在 设备 配置 改变 发 生 时 《比如 设备 旋转 ) ， 在 
内 存 里 缓存 结果 数据 。 随 后 ， 感 知 fragment 生 命 周 期 变化 ， 在 需要 时 使 
用 绥 存 的 数据 ， 而 不 是 发 起 新 请 求 。 


ViewModel 是 解决 这 个 问题 的 一 个 好 工具 (如 果 想 复习 ViewModel， 请 
阅读 第 4 章 相 关内 容 ) 。 


首先 ， 你 需要 在 app/build.gradle 里 添加 1ifecycle-extensions 依 赖 ， 
如 代码 清单 24-29 所 示 。 


代码 清单 24-29 ”添加 1ifecycle-extensions 依 赖 
Capp/build.gradle ) 


dependencies { 


implementation 'androidx.appcompat:appcompat:1.0.2' 


implementation 'androidx.lifecycle:lifecycle-extensions:2.0.0' 


接 下 来 ， 如 代码 清单 24-30 所 示 ， 新 建 一 个 名 

为 PhotoGalleryViewModel 的 ViewModel 类 。 添 加 一 个 属性 ， 用 于 保 
存 持 有 图 片 数据 的 LiveData 对 象 。 在 ViewModel 初 始 化 时 发 起 下 载 图 
片 的 网 络 请 求 ， 并 把 结果 保存 在 刚 添加 的 属性 里 。 


代码 清单 24-30 ”新 建 一 个 ViewModel 类 
(PhotoGallery ViewModel.kt) 


class PhotoGalleryViewModel : ViewModel() ( 


val galleryItemLiveData: LiveData<List<GalleryItem>> 


init { 
galleryItemLiveData = FlickrFetchr().fetchPhotos() 


在 PhotoGalleryViewMode1l1 的 init{} 初 始 化 块 中 ， 我 们 调 

用 FlickrFetchr() .fetchPhotos() 函 数 发 起 了 下 载 图 片 数据 的 网 络 
请 求 。 既 然 这 个 ViewMode1 在 其 提供 者 的 生命 周期 内 〈 首 次 

癌 ViewModelProviders 类 申请 ) 只 会 创建 一 次 ， 那 么 网 络 请 求 也 只 会 
有 一 个 (用 户 启 动 PhotoGalleryFragment 时 ) 。 在 发 生 像 设 备 旋 转 这 
样 的 配置 改变 时 ，ViewModel1 仍 会 保留 在 内 存 里 ， 这 样 ， 销 毁 后 重建 的 
fragment 就 能 从 它 这 里 获得 原始 请 求 的 结果 。 


按照 这 种 设计 ， 即 使 用 户 刚 启 动 应 用 就 退出 ，FlLickrFetchr 仓 库 也 会 
继续 执行 网 络 请 求 。 在 PhotoGallery 应 用 中 ， 网 络 请 求 结果 会 被 忽略 。 
但 在 一 个 生产 应 用 中 ， 你 应 该 把 网 络 请 求 结 果 保 存在 数据 库 或 某 个 本 地 
存储 设备 上 ， 这 样 应 用 再 次 局 动 后 可 让 图 片 下 载 继 续 完 成 


当 用 户 退 出 应 用 时 ， 如 果 想 停止 进行 中 的 FlickrFetchr 网 络 请 求 ， 可 
以 更 新 FlickrFetchr 把 表示 网 络 请 求 的 Call 对 象 保存 起 来 ， 然 后 

在 ViewModel 从 内 存 消 失 时 取消 网 络 请 求 。 (具体 如 何 实 现 ， 请 阅读 
24.7 Te: 2 


更 新 PhotoGalleryFragment.onCreate(...) 函 数 ， 获 取 
PhotoGalleryViewModel 对 象 ， 把 它 保 存在 一 个 属性 里 ， 如 代码 清单 
24-31 所 示 。 现 在 ， 和 FlickrFetchr 的 交互 

由 PhotoGalleryViewModel 代 劳 了 ， 因 此 还 要 删除 这 部 分 代码 。 


代码 清单 24-31 获取 ViewMode1 实 例 (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoGalleryViewModel: PhotoGalleryViewModel 
private lateinit var photoRecyclerView: RecyclerView 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


—#fliekrLiveData-ebservet 

— —this;, 

— —Qbserver—(-galleryltems— 

— — kog-d(TAG;—"Respense—received:—$galleryltems") 
—» 


photoGalleryViewModel - 
ViewModelProviders.of(this).get(PhotoGalleryViewModel::clas 


之 前 说 过 ， 首 次 向 某 个 指定 生命 周期 所 有 者 请 求 ViewMode1 时 ， 一 
个 ViewMode1 新 实例 会 被 创建 。 由 于 发 生 像 设备 旋转 这 样 的 设备 配置 改 
变 时 PhotoGalleryFragment 会 被 销毁 后 重建 ， 因 此 原来 的 ViewModel 


会 保留 下 来 。 随 后 再 请 求 ViewModel 时 ， 会 取 到 最 初创 建 的 同 
一 ViewMode1 实 例 。 


现在 ， 更 新 PhotoGalleryFragment， 在 fragment 视 图 创建 时 ， 同 步 观 
察 PhotoGalleryViewMode1 的 LiveData 的 变化 ， 如 代码 清单 24-32 所 
示 。 目 前 ， 先 输出 日 志 表 明 数 据 已 接收 到 。 之 后 ， 我 们 会 使 用 返回 的 图 
片 数 据 更 新 RecyclerView。 


代码 清单 24-32 ”观察 ViewModel 的 
LiveData (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreateView( 


): View { 


} 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 
super.onViewCreated(view, savedInstanceState) 
photoGalleryViewModel.galleryItemLiveData.observe( 
viewLifecycleOwner, 
Observer ( galleryItems -> 
Log.d(TAG, "Have gallery items from ViewModel $galleryItems 
// Eventually, update data backing the recycler view 


后 面 ， 我 们 还 会 更 新 UI 相 关 的 部 件 〈 比 如 RecyclerView adapter) 啊 应 数 
据 变 化 。 在 onViewCreated(... ) 函 数 里 开始 观察 ， 可 以 保证 UI 部 件 和 
其 他 关联 对 象 随 时 做 好 啊 应 准备 。 同 时 ， 也 能 让 我 们 有 效应 对 
PhotoGalleryFragment 失 去 关联 而 导致 其 视图 被 销毁 的 情况 。 也 就 是 
说 ， 保 证 PhotoGalleryFragment 重 新 被 关联 ， 且 其 视图 重建 

后 ，LiveData 订 阅 能 重新 添加 回来 。 


(实战 环境 下 ， 你 可 能 会 看 到 LiveData 观 察 放 在 onCreateView(...) 
或 onActivityCreated(...) 函 数 里 的 情况 。 这 么 做 虽然 也 可 以 ， 但 不 
太 容易 看 出 被 观察 的 LiveData 和 视图 生命 期 之 间 的 关系 。) 


传递 viewLifecycleOwner 作 为 LifecycleOwner 参 数 给 
LiveData.observe(Lifecycle0wner，0bserver) 函 数 ， 可 以 保证 在 
fragment 视 图 被 销毁 时 ，LiveData 能 及 时 删除 你 的 观察 者 对 象 。 


运行 PhotoGallery 应 用 。 使 用 FlickrFetchr 过 滤 Logcat 窗 口 日 志 。 旋 转 
模拟 器 几 次 。 无 论 设备 怎么 旋转 ， 你 应 该 只 看 到 一 次 FlickrFetchr: 
Response received 日 志 输 出 。 


24.5 ”在 RecyclerView 里 显示 结果 


作为 本 章 最 后 一 个 任务 ， 我 们 转 到 视图 层 ， 让 PhotoGalleryFragment 
的 RecyclerView 显 示 图 片 的 标题 。 


首先 ， 在 PhotoGalleryFragment 里 定义 一 个 ViewHolder 类 ， 如 代码 
清单 24-33 所 示 。 


代码 清单 24-33 ”定义 一 个 ViewHolder 类 
(PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 


} 


private class PhotoHolder(itemTextView: TextView) 
: RecyclerView.ViewHolder(itemTextView) { 


val bindTitle: (CharSequence) -> Unit = itemTextView: :setText 


接 下 来 ， 添 加 一 个 RecyclerView.Adapter， 基 于 GalleryItem 按 需 提 
供 PhotoHolder， 如 代码 清单 24-34 所 示 。 


代码 清单 24-34 ”添加 RecyclerView.Adapter 实 现 
( PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


private class PhotoHolder(itemTextView: TextView) 
: RecyclerView.ViewHolder(itemTextView) { 


val bindTitle: (CharSequence) -> Unit = itemTextView: :setText 


} 


private class PhotoAdapter(private val galleryItems: List<GalleryItem>) 
: RecyclerView.Adapter<PhotoHolder>() { 


override fun onCreateViewHolder( 
parent: ViewGroup, 
viewType: Int 
): PhotoHolder { 
val textView = TextView(parent.context) 
return PhotoHolder(textView) 
I 


override fun getItemCount(): Int = galleryItems.size 
override fun onBindViewHolder(holder: PhotoHolder, position: Int) { 


val galleryItem - galleryItems[position] 
holder.bindTitle(galleryItem.title) 


既然 已 为 RecyclerView 准 备 好 一 切 ， 那 就 添加 代码 在 LiveData 观 察 者 
回调 触发 时 ， 关 联 上 带 图 片 数 据 的 adapter， 如 代码 清单 24-35 所 示 。 


代码 清单 24-35 ”添加 adapter 更 新 代码 (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 
super.onViewCreated(view, savedInstanceState) 
photoGalleryViewModel.galleryItemLiveData.observe( 
this, 
Observer ( galleryItems -> 


LP Évantad iiy update- data backing 1 ; 


photoRecyclerView.adapter = PhotoAdapter(galleryItems) 


return view 


} 


至 此 ， 本 章 的 任务 都 完成 了 。 运 行 PhotoGallery 应 用 ， 你 应 该 可 以 看 到 
下 载 图 片 的 一 个 个 文字 标题 了 类似 图 24-2)。 


24.6 RAFA: 其 他 JSON 数 据 解析 器 和 数据 格 
A 


Gson AIT, (H'EJEAXEME— BY ALISON AEDT as. Squarezy n] 
LA A 7B SS ISON ACHE ENT 48 Moshi. Moshifi Y Gson 
的 一 些 优点 ， 试 图 让 JSON 数 据 解析 更 高 效 一 些 。 同 样 ，Square 公 司 也 为 
Retrofit 提 供 了 Moshi 版 数据 类 型 转换 器 。 


除了 JSON 数 据 类 型 ，Retrofit 也 支持 其 他 常见 数据 格式 ， 比 如 XML， 其 
至 是 Protobufs。 除 了 Gson 和 Moshi， 支 持 Retrofit 的 数据 解析 库 还 有 很 
多 ， 你 可 以 根据 自己 的 数据 转换 配置 自行 选择 。 


24.7 深入 学 习 : 撤销 网 络 请 求 


在 当前 应 用 实现 里 ，PhotoGalleryFragment 会 让 
PhotoGalleryViewModel 发 起 网 络 请 求 下 载 图 片 数据 。 如 果 应 用 一 启 
动 ， 用 户 就 快速 按 回 退 键 ， 那 么 网 络 数据 下 载 请 求 大 概率 还 是 会 继续 执 
行 。 当 然 ， 这 并 不 会 导致 内 存 泄漏 ， 因 为 FlickrFetchr 既 没有 引用 任 
何 UI 相 关 的 组 件 ， 也 没有 引用 PhotoGalleryViewModel。 


然而 ， 因 为 忽略 了 网 络 请 求 执 行 ， 所 以 它 继 续 执 行 必然 会 滔 费 电力 、 

CPU 运算 能 力 ， 以 及 可 能 的 数据 流量 《假如 用 户 订 购 了 流量 包 ) 。 不 
过 ， 也 不 用 担心 后 果 有 多 严重 ， 因 为 当前 PhotoGallery 应 用 只 会 抓 取 少 
量 数据 。 


在 大 多 数 生 产 应 用 里 ， 你 很 可 能 会 让 数据 下 载 请 求 继续 执行 。 当 然 ， 你 
下 载 结果 ， 应 该 会 找 个 地 方 《比如 数据 库 ) 把 数据 保存 起 


既然 当前 应 用 不 保存 下 载 数据 ， 那 么 你 可 以 在 ViewModel 被 销毁 时 撤销 
网 络 数 据 下 载 请 求 。 具 体 实现 时 ， 可 以 把 代表 网 络 请 求 的 call 对 象 保存 
起 来 ， 然 后 调用 Call.cancel() 函 数 撤销 网 络 数据 下 载 请 求 : 


class SomeRespositoryClass { 


private lateinit var someCall: Call<SomeResponseType> 


fun cancelRequestInFlight() { 


if (::someCall.isInitialized) { 
someCall.cancel() 


在 你 撤销 一 个 Cal1 对 象 时 ， 一 个 对 应 的 Callback.onFailure(...) 函 
数 也 会 被 调用 。 你 可 以 检查 call.isCancelled 的 值 ， 判 断 callback 失 
败 是 不 是 因为 撤销 了 网 络 请 求 〈 返 回 true 值 表示 撤销 成 功 ) 。 


为 了 绑 定 ViewMode1l 的 生命 周期 ， 准 确 地 在 ViewModel 被 销毁 时 才 撤 销 
网 络 请 求 ， 你 可 以 覆盖 ViewModel.onCleared() 函 数 。 这 个 函数 会 

在 ViewMode1 即 将 被 销毁 时 《比如 用 户 使 用 回 退 键 退 出 应 用 ) 调用 。 
class SomeViewModel : ViewModel() ( 


private val someRepository - SomeRespositoryClass() 


override fun onCleared() ( 


super.onCleared() 
someRepository.cancelRequestInFlight() 
} 


24.8 TRAM: 管理 依赖 
Fl1ickrFetchr 对 Flickr 图 片 数据 来 源 做 了 一 层 封 装 。 无 顷 关 心 数 据 来 目 


哪里 ， 其 他 组 件 〈 比 如 PhotoGalleryFragment) 可 直接 调用 它 获 取 
Flickr 数 据 。 


FlickrFetchr 自 己 也 不 知道 该 如 何 从 Flickr 下 载 JSON 数 据 。 事 实 
上 ，FlickrFetchr 在 FlickrApi 的 帮助 下 ， 才 知道 端点 URL 是 什么 ， 
才能 访问 它 ， 以 及 执行 实际 下 载 JSON 数 据 的 任务 。 这 时 ， 我 们 说 
FlickrFetchr 对 FlickrApi 有 依赖 。 


如 下 代码 所 示 ，FlickrApi 是 在 FlickrFetchr 的 init 初 始 化 块 里 进行 
初始 化 的 。 


class FlickrFetchr { 
private val flickrApi: FlickrApi 


init { 
val retrofit: Retrofit = Retrofit.Builder() 
.baseUrl("https://www.flickr.com/") 
.addConverterFactory(ScalarsConverterFactory.create()) 
.build() 


flickrApi = retrofit.create(FlickrApi::class.java) 


} 


fun fetchContents(): LiveData<String> { 


} 


对 于 简单 应 用 ， 这 种 做 法 没什么 问题 ， 但 有 一 些 潜在 的 问题 需要 注意 。 


首先 ， 单 元 测试 FlickrFetchr 会 有 困难 。 回 顾 第 20 章 ， 我 们 知道 ， 单 
元 测试 的 目标 是 验证 某 个 类 及 其 与 其 他 类 交互 的 行为 。 要 想 正 确 单元 测 
试 FlickrFetchr， 你 需要 把 它 和 FlickrApi 阳 离开 来 。 但 这 有 点 难 
办 ， 因 为 FlickrApi 要 在 FlickrFetchr 的 init 块 里 初始 化 。 


因而 ， 你 没有 办 法 模拟 一 个 FlickrApi 实 例 用 于 FlickrFetchr 测 试 。 

这 就 有 问题 了 ， 因 为 涉及 fetchContents() 函 数 的 任何 测试 都 需要 发 

起 网 络 数据 下 载 请 求 。 测 试 能 人 否 成 功 要 依赖 于 网 络 状 态 如 何以 及 测试 时 
Flickr 后 端 API 是 否 可 用 。 


另外 ，F1ickrApi 实 例 化 也 没 那么 简单 。 创 建 FlickrApi 实 例 之 前 ， 你 
必须 首先 构建 和 配置 Retrofit 实 例 。 无 论 在 哪里 ， 要 想 创建 FLickrApi 实 
例 ， 你 都 得 重 写 一 遍 Retrofit 配 置 代码 。 


最 后 ， 到 处 创建 FlickrApi 新 实例 也 会 有 问题 。 对 于 移动 设备 来 讲 ， 创 
建 对 象 还 是 挺 占 资源 的 。 实 践 中 ， 你 应 该 尽量 在 应 用 层级 共享 类 实例 ， 
避免 一 些 不 必要 的 对 象 分 配 。 事 实 上 ，FlickrApi 是 最 理想 的 共享 类 ， 
因为 它 不 需要 变量 实例 状态 。 


Dependency injection (DI) 是 一 种 设计 模式 ， 能 把 FlickrApi 的 代码 逻 
辑 中 心 化 处 理 ， 即 创建 一 个 各 个 类 都 需要 的 依赖 。 在 PhotoGallery 里 应 
用 DI 模式 后 ， 每 次 创建 FlickrFetchr 实 例 的 时 候 ， 只 要 传 入 一 
个 FlickrApi 实 例 参 数 就 行 了 。 现 在 ，PhotoGallery 应 用 能 够 实现 : 

e 从 FlickrFetchr 里 抽 离 并 封装 FlickrApi 的 初始 化 逻辑 ; 

e 整个 应 用 里 只 需要 一 个 FlickrApi 单 例 实例 ; 

e. 在 单元 测试 时 可 以 使 用 模拟 版 本 的 FlickrApi 了。 


应 用 DI 模式 后 ，FlickrFetchr 类 的 代码 实现 大 致 这 样 : 


class FlickrFetchr(flickrApi: FlickrApi) { 
fun fetchContents(): LiveData<String> { 


} 


} 


注意 ， 应 用 DI 模 式 并 不 要 求 所 有 依赖 都 使 用 单 例 模式 。 传 入 一 

个 FlickrApi 实 例 就 能 创建 FlickrFetchr 实 例 。FlickrFetchr 的 这 种 
实例 化 方式 很 灵活 。 你 只 需要 根据 使 用 场景 提供 一 个 FLickrApi 新 实例 
或 共享 实例 就 可 以 了 。 


在 软件 开发 领域 ，DI 模 式 是 个 广泛 的 话题 ， 涉 及 Android 开 发 之 外 的 方 
方面 面 。 本 节 讨 论 的 知识 点 只 是 一 些 毛 皮 而 已 。 市 面 上 有 不 少 整 本 都 讨 
论 DI 概念 的 图 书 。 社 区 也 有 一 些 开发 库 可 帮助 开 友 者 轻松 实现 DI。 如 果 
需要 在 应 用 里 使 用 DI， 你 应 该 考虑 使 用 一 些 这 样 的 开发 库 。 这 样 ， 你 不 
仅 能 获得 实施 指导 ， 还 能 少 写 一 些 代码 。 


本 书 撰写 时 ， 在 Android 平 台 上 ，Google 官 方 推荐 的 DI 实 现 库 是 Dagger 
2。 


24.9 ”挑战 练习 : HE X. Gson/x Hr /,J zi 


Flickri PI JSON Wai e EX (824-6) 。 在 前 面 的 
24.3.1 节 中 ， 我 们 创建 过 模型 对 象 来 映射 JSON 数 据 结 构 。 但 是 ， 如 果 最 
外 层 的 数据 用 不 上 呢 ? 如 果 将 无 用 数据 对 应 的 模型 对 象 删 掉 ， 那 么 代码 


会 不 会 更 简洁 ? 


通过 匹配 Kotlin 属 性 名 〈 或 者 是 @SerializedName 注 解 ) 和 JSON 字 段 
名 ，Gson 默 认 会 直接 把 所 有 JSON 数 据 映射 到 你 的 模型 对 象 。 不 过 ， 你 
可 以 自 定 义 一 个 com.google.gson.JsonDeserializer 来 改变 Gson 的 默认 行 


请 实现 一 个 自 定 义 反 序 列 化 器 ， 把 外 层 的 JSON 数 据 〈 了 映 

射 FLickrResponse 的 那 层 数据 ) 剔除 。 这 个 目 定 义 反 序 列 化 器 应 该 返 
回 一 个 持 有 图 片 数据 的 PhotoResponse 对 象 。 要 完成 这 个 任务 ， 首 先 创 
建 一 个 继承 com.google.gson.JsonDeserializer 的 新 类 ， 并 履 盖 父 
类 的 deserialize(...) 函 数 : 


class PhotoDeserializer : JsonDeserializer<PhotoResponse> { 


override fun deserialize( 
json: JsonElement, 
typeOfT: Type?, 
context: JsonDeserializationContext? 


): PhotoResponse { 
// Pull photos object out of JsonElement 
// and convert to PhotoResponse object 


} 
} 


查看 Gson API 文 档 ， 学 习 如 何 解析 JsonElement 并 把 它 转换 为 模型 对 
象 。 (小 提示 : 请 仔细 阅读 ]sonElement、Json0bject 和 Gson 这 三 部 
TAR. ) 


搞定 了 目 定义 反 序 列 化 器 后 ， 就 可 以 更 新 FlickrFetchr 初 始 化 代码 


o 


e 使 用 GsonBuilder 创 建 一 个 Gson 实 例 ， 并 登记 你 的 反 序 列 化 器 为 
类 型 适配器 。 


。 创建 一 个 使 用 Gson 实 例 作 为 转换 器 的 
retrofit2.converter.gson.GsonConverterFactory2£ fill. 

° wes 以 使 用 自 定 义 的 Gson 数 据 转 换 器 工厂 实 
列 。 


最 后 ， 从 项 目 里 删除 FlickrResponse， 并 相应 更 新 各 处 的 依赖 代码 。 


24.10 ”挑战 练习 : 分 页 


getList 方 法 默认 返回 一 页 100 个 结果 的 数据 。 不 过 ， 该 方法 还 有 个 叫 
作 page 的 参数 ， 可 以 用 它 返 回 第 二 页 、 第 三 页 等 更 多 页 数据 。 


要 完成 这 个 挑战 ， 建 议 先 研 究 一 下 Jetpack 分 页 亩 ， 然 后 用 它 捐 定 
PhotoGallery 应 用 的 分 页 实现 。 当 然 ， 你 也 可 以 自己 写 代码 实现 。 不 
过 ， 使 用 分 页 库 显 然 工 作 量 更 小 ， 且 不 容易 出 错 。 


24.11 ”挑战 练习 : 动态 调整 网 格 列 


当前 ， 显 示 图 片 标题 的 网 格 固 定 有 3 列 。 请 编写 代码 动态 调整 网 格 列 
数 ， 实 现在 模 屏 或 大 屏幕 设备 上 显示 更 多 列 标题 。 


实现 这 个 目标 有 个 简单 方法 : 分 别 为 不 同 的 设备 配置 或 屏幕 尺寸 提供 整 
数 修饰 资源 。 这 实际 和 第 17 章 中 为 不 同 尺 寸 屏 幕 提 供 不 同 布局 的 方式 关 
不 多 。 整 数 修饰 资源 应 放置 在 res/values 目 录 中 。 有 具体 实施 细节 可 参阅 
Android 开 发 者 文档 。 


然而 ， 提 供 整 数 修饰 资源 的 方式 不 太 好 确定 网 格 列 细 分 粒度 《只 能 攒 经 
验 预 完 定义 列 数 ) 。 下 面 再 介绍 一 个 颇具 挑 碾 的 方法 : 在 fragment 的 视 
图 创建 时 就 计算 并 设置 好 网 格 列 数 。 显 然 ， 这 种 方式 更 加 灵活 实用 。 基 
于 Recyclerview 的 当前 宽度 和 预定 义 网 格 列 宽 ， 残 可 以 计算 出 列 数 。 


实施 前 还 有 个 问题 要 解决 : 你 不 能 在 onCreateView(...) 函 数 中 计算 
网 格 列 数 ， 因 为 这 个 时 候 RecyclerView 的 大 小 还 没有 改变 。 不 过 ， 可 
DASE EViewTreeObserver.OnGlobalLayoutListener iy 287; 1l 
计算 列 数 的 onGlobalLayout() 函 数 ， 然 后 使 

用 addOonGlobalLayoutListener() 把 监听 器 添加 给 RecyclerView 视 
图 。 


第 25 章 Looper. Handler! 
HandlerThread 


从 Flickr 下 载 并 解析 JSON 数 据 后 ， 接 下 来 的 任务 就 是 下 载 并 显示 图 片 。 
本 章 ， 我 们 将 学 习 如 何 使 用 Looper、Handler 和 HandlerThread 动 态 
下 载 和 显示 图 片 。 学 完 本 章 ， 你 将 对 应 用 的 主线 程 有 一 个 比较 深入 的 理 
解 ， 能 够 搞 清楚 主线 程 和 后 台 线 程 各 自 适合 执行 什么 样 的 任务 。 最 后 ， 
你 将 学 习 如 何 实 现 主线 程 和 后 台 线 程 之 间 的 通信 。 


25.1 ”配置 RecyclerView 以 显示 图 片 


在 PhotoGalleryFragment 中 ， 当 前 PhotoHolder 准 备 了 TextView 供 
Recyclerview 的 GridLayoutManager 显 示 。 每 个 TextView 显 示 一 
个 GalleryItem 标 题 。 


要 显示 图 片 ， 就 要 让 PhotoHolder 提 供 ImageView。 最 终 ， 
个 ImageView 都 应 显示 一 张 从 GalleryItem 的 ur1 地 址 下 载 的 图 片 。 


首先 ， 为 GalleryItem 创 建 一 个 名 为 list_item_gallery.xml 的 布局 文件 。 
该 布局 包含 一 个 ImageView 部 件 ， 如 代码 清单 25-1 所 示 。 


代码 清单 25-1 GalleryItem 布 局 
(res/layout/list_item_gallery.xml ) 


<?xml version-"1.0" encoding-"utf-8"?» 
«ImageView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 


android: layout_height="12@dp" 
android: layout_gravity="center" 
android: scaleType="centerCrop"/> 


ImageView 由 RecyclerVvView 的 GridLayoutManager 负 责 管理 ， 这 意味 
着 其 宽度 会 变 ， 而 高 度 回 定 。 为 最 大 化 利用 ImageView 的 空间 ， 应 设置 
它 的 scaleType 属 性 值 为 centerCrop。 这 个 属性 值 的 作用 是 先 居 中 放 
置 图 片 ， 然 后 放大 较 小 图 片 ， 裁 玖 较 大 图 片 〈 裁 两 涉 〉 以 匹配 视图 。 


接 下 来 更 新 PhotoHolder 类 ， 用 ImageView 蔡 换 TextView。 同 时 ， 用 
一 个 新 函数 奉 换 掉 bindTit1le， 用 来 设置 ImageView 的 Drawable， 如 
代码 清单 25-2 所 示 。 


代码 清单 25-2 ”更 新 PhotoHolder (PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


private class PhotoHolder(private val itemImageView: ImageView) 
: RecyclerView.ViewHolder(itemImageView) { 


1 bindTitle: (chars TOTEM 


val bindDrawable: (Drawable) -> Unit = itemImageView: :setImageDra 


之 前 ， 传 入 PhotoHolder 构 造 函 数 的 是 TextView。 现 在 ， 新 版 
本 PhotoHolder 构 造 函 数 需要 一 个 ImageView。 


如 代码 清单 25-3 所 示 ， 更 新 PhotoAdapter 的 
onCreateViewHolder(...) 函 数 ， 实 例 化 list_item_gallery.xml 布 局 。 
然后 将 结果 返回 给 PhotoHolder 的 构造 函数 。 添 加 inner 关 键 字 ， 让 
PhotoAdapter 直 接 访问 到 父 activity 的 1ayoutInflater 属 性 。 C4 
然 ， 你 也 可 以 直接 从 parent.context 里 得 到 布局 实例 工具 ， 但 为 了 方 
便 后 面 访问 父 activity 的 属性 和 函数 ， 这 里 用 了 内 部 类 。 ) 


代码 清单 25-3 ”更 新 photoAdapter 的 onCreateViewHolder(...) 
函数 CPhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private inner class PhotoAdapter(private val galleryItems: List<Gallery 
: RecyclerView.Adapter<PhotoHolder>() { 


override fun onCreateViewHolder( 
parent: ViewGroup, 
viewType: Int 

): PhotoHolder { 


val view - layoutInflater.inflate( 
R.layout.list item gallery, 
parent, 
false 

) as ImageView 

return PhotoHolder(view) 


接 下 来 ， 需 要 为 每 个 ImageView 设 置 占 位 图 ， 等 成 功 下 载 图 片 后 再 做 蔡 
换 。 在 随 书 代码 文件 中 找到 bill_up_dlose.png， 把 它 复 制 到 项 目的 
res/drawable 目 录 中 。 


更 新 PhotoAdapter 的 onBindViewHolder(...) 函 数 ， 使 用 占 位 图 设 
置 ImageView 的 Drawable， 如 代码 清单 25-4 所 示 。 


代码 清单 25-4” 绑 定 默 认 图 片 (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private inner class PhotoAdapter(private val galleryItems: List«Gallery| 
: RecyclerView.Adapter<PhotoHolder>() { 


override fun onBindViewHolder(holder: PhotoHolder, position: Int) { 
val galleryItem = galleryItems[position] 


ER 


val placeholder: Drawable = ContextCompat.getDrawable( 
requireContext(), 
R.drawable.bill up close 

) ?: ColorDrawable() 

holder.bindDrawable(placeholder) 


注意 ， 这 里 你 提供 了 一 个 ColorDrawable 对 象 ， 以 
防 ContextCompat .getDrawable(...) 返 回 nul1 值 。 


运行 PhotoGallery 应 用 ， 你 应 该 能 看 到 B 记 的 一 组 大 头 照 ， 如 图 25-1 所 
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图 25-1 满 屏 的 Bi 大 头 照 


25.2 ”准备 下 载 数据 


当前 ，Retrofit API 接 口 还 不 支持 下 载 图 片 。 现 在 我 们 就 来 解决 这 个 问 
题 。 添 加 一 个 新 函数 ， 以 字符 串 URL 作 为 其 参数 ， 返 回 一 个 可 执行 的 
retrofit2.Cal1 对 象 〈 其 返回 结果 是 okhttp3.ResponseBody) ， 如 
代码 清单 25-5 所 示 。 


代码 清单 25-5 ”更 新 FlickrApi 接 口 类 Capi/FlickrApi.kt) 


interface FlickrApi { 


@GET 
fun fetchUrlBytes(QUrl url: String): Call«ResponseBody» 


DLL CSR 


新 添加 的 这 个 API 函 数 和 之 前 的 不 太一 样 。 它 直接 使 用 传 入 的 URL 参 数 
来 决定 从 哪里 下 载 数 据 。 这 里 ， 无 参数 的 @GET 注 解 和 
fetchUrlBytes(.. .) 函 数 中 的 @Un 注 解 搭 配 起 来 ， 会 让 Retrofit 覆 盖 
基 URL。 也 就 是 说 ，Retrofit 会 使 用 传 入 fetchUrlBytes(...) 疯 数 的 
URL 去 联网 。 


在 FlickrFetchr 类 里 ， 添 加 一 个 函数 从 指定 URL 下 载 数据 ， 然 后 解析 
啊 应 数据 为 Bitmap 对 象 ， 如 代码 清单 25-6 所 示 。 


代码 清单 25-6 ”在 FlickrFetchr 类 里 添加 图 像 下 载 函 数 
(FlickrFetchr.kt ) 


class FlickrFetchr ( 


@WorkerThread 
fun fetchPhoto(url: String): Bitmap? { 
val response: Response<ResponseBody> = flickrApi.fetchUrlBytes(url) 


val bitmap = response.body()?.byteStream()?.use(BitmapFactory: :deco 
Log.i(TAG, "Decoded bitmap=$bitmap from Response=$response" ) 
return bitmap 


使 用 Cal1.execute() 同 步 执行 网 络 请 求 。 之 前 我 们 一 直 在 强调 ， 在 主 
线程 上 执行 网 络 请 求 是 不 被 允许 的 。@WorkerIhread 注 解 表 
示 ，fetchPhoto(...) 函 数 只 能 在 后 台 线 程 上 执行 。 


然而 ， 注 解 本 身 并 不 能 创建 线程 ， 也 不 知道 如 何 把 任务 放 在 后 台 线 程 
上 。 这 需要 你 来 编码 搞定 。 如果 从 一 个 以 @MainThread 或 @UiThread 
注解 的 函数 里 调用 fetchPhoto(...) 函 数 ， 那 么 @WorkerThread 注 解 会 
产生 一 个 Lint 错 误 提 示 。 然 而 ， 本 书 把 写 时 ， 还 没 看 到 哪个 Android 生 命 
周期 有 @MainThread 或 @UiThread 注 解 。) 最 后 ， 从 你 创建 的 后 台 线 程 
调用 fetchPhoto(String)。 


使 用 ResponseBody .byteStream() 函 数 ， 我 们 从 响应 数据 里 取出 
java.io.InputStream， 再 传 

入 BitmapFactory.decodeStream(InputStream) 供 其 创建 Bitmap 对 
象 。 


响应 流 和 字 节 流 用 完 都 应 该 关闭 。 由 于 InputSstream 实 现 了 Closeable 
接口 ， 因 此 Kotlin 标 准 函 数 use(. . .) 会 
在 BitmapFactory.decodeSstream(. ..) 函 数 返回 值 后 完成 清理 工作 。 


最 后 ， 返 回 BitmapFactory 构 建 的 Bitmap 对 象 ，fetchPhoto(... ) 函 
数 结束 使 命 。 现 在 ， 我 们 的 API 接 口 和 仓库 有 下 载 图 片 的 能 力 了 。 


不 过 ， 别 局 兴 得 太 早 ， 要 做 的 事 还 有 很 多 。 


25.3 ”批量 下 载 缩 略 图 


当前 ，PhotoGallery 应 用 的 联网 代码 会 这 样 工 

YE: PhotoGalleryViewModeli/]H]FlickrFetchr().fetchPhotos() 
函数 从 Flickr 下 载 JSON 数 据 。F1lLickrFetchr 立 即 返 回 一 个 

空 LiveData<List<GalleryItem>> 对 象 ， 并 把 从 Flickr 下 载 数据 的 异 
步 Retrofit 请 求 放 入 任务 队列 。 网 络 数据 下 载 请 求 在 后 台 线 程 上 执行 。 


数据 下 载 完 成 后 ，FlickrFetchr 解 析 JSON 数 据 ， 将 结果 存 
入 GalleryItem 集 合 ， 然 后 发 布 给 它 返 回 的 LiveData 对 象 。 最 终 每 
个 GalleryItem 都 得 到 一 个 指 问 某 张 缩 略 图 的 URL。 


接 下 来 是 下 载 这 些 URL 指 癌 的 缩 略 图 。 具 体 该 怎么 做 

呢 ?FlickrFetchr 默 认 只 会 请 求 下 载 100 个 URL。 因 此 ，GalleryItem 
合 最 多 只 持 有 100 个 URL 下 载 链接 。 一 个 办 法 是 ， 我 们 每 次 下 载 一 

张 ， 直 到 下 完 100 张 。 最 后 ， 通 知 ViewMode1， 让 所 有 下 载 图 片 全 部 显 

示 在 RecyclerView 视 图 中 。 


然而 ， 一 次 性 下 载 全 部 缩 略 图 存在 两 个 问题 。 首 先 ， 下 载 比较 耗 时 ， 而 
且 在 下 载 完成 前 ，UI 都 无 法 完成 更 新 。 这 样 ， 网 速 较 慢 时 ， 用 户 就 只 能 
对 着 Bill 的 照片 看 好 久 。 


其 次 ， 保 存 缩 略 图 也 是 个 问题 。100 张 缩 略图 保存 在 内 存 中 国 然 轻 松 ， 
那 1000 张 呢 ? 如 果 还 要 实现 无 限 滚 动 来 显示 图 片 呢 ? 显然 ， 内 存 会 耗 
尺 。 


考虑 到 这 类 问题 ， 很 多 应 用 通常 会 选择 仪 在 需要 显示 图 片 时 才 去 下 载 。 
显然 ，RecyclervView 及 其 adapter 应 负责 实现 按 需 下 载 。adapter 触 发 图 


片 下 载 就 放 在 onBindviewHolder(...) 函 数 中 实现 。 


那 到 底 要 怎么 做 呢 ? 你 可 能 想到 为 所 有 图片 都 准备 好 异步 执行 的 Retrotit 
网 络 请 求 。 然 而 ， 这 样 一 来 ， 你 不 仅 要 管理 所 有 Cal1 对 象 ， 还 要 处 理 它 
们 和 各 个 ViewHolder 以 及 fragment 自 身 的 关联 关系 。 


办 法 总 是 有 的 ， 你 可 以 创建 一 个 专用 后 台 线 程 。 这 个 线程 专门 负 贡 接收 
并 处 理 网 络 下 载 请 求 ， 一 次 一 个 。 然 后 ， 在 各 个 下 载 请 求 完 成 时 提供 相 
应 的 下 载 图 片 。 既 然 所 有 的 网 络 请 求 都 能 区 给 后 台 线 程 管理 ， 那 么 要 想 
清除 或 者 全 部 停 掉 它们 都 能 轻松 办 到 。 


25.4 创建 后 全线 程 
继承 HandlerThread 类 ， 创 建 一 个 名 为 ThumbnailDownloader 的 新 
类 。 然 后 ， 添 加 一 个 构造 函数 、 一 个 名 为 queueThumbnai1l() 的 存根 函 
数 以 及 一 个 quit( ) 禾 六 函数 (线程 退出 通知 方法 ， 稍 后 会 用 到 ) ， 如 
代码 清单 25-7 所 示 。 

代码 清单 25-7 初始 线程 代码 “(ThumbnailjDownloader.kt) 


private const val TAG = "ThumbnailDownloader" 


class ThumbnailDownloader«in T» 
: HandlerThread(TAG) { 


private var hasQuit - false 


override fun quit(): Boolean { 
hasQuit - true 
return super.quit() 


} 


fun queueThumbnail(target: T, url: String) { 
Log.i(TAG, "Got a URL: $url") 


} 


iExX&, ThumbnailDownloader2S [EH] f «T»iz 702 
数 。ThumbnailDownloader 类 的 使 用 者 (这 里 
指 PhotoGalleryFragment) 需要 使 用 某 些 对 象 来 识别 每 次 下 载 ， 并 确 


定 该 用 下 载 图 片 更 新 哪个 UI 元 素 。 这 里 ， 相 比 限制 使 用 特定 类 型 的 对 
象 ， 使 用 泛 型 会 更 灵活 。 


queueThumbnail() 函 数 需 要 一 个 T 类 型 对 象 〈 标 识 具 体 哪 次 下 载 ) 和 
一 个 String 参 数 (URL 下 载 链接 ) 。 同 时 ， 它 也 是 PhotoAdapter 在 
其 onBindViewHolder(...) 实 现 函 数 中 要 调用 的 函数 。 


25.4.1 创建 生命 周期 感知 线程 


既然 ThumbnailDownloader 的 唯一 使 命 是 下 载 并 提供 图 片 给 
PhotoGalleryFragment， 那 么 我 们 让 这 个 线程 和 
PhotoGalleryFragment 生 死相 依 “用户 觉 察 得 到 ) 。 也 惑 是 说 ， 用 户 
启动 应 用 ， 就 让 ThumbnailDownloader 线 程 运行 起 来 ， 用 户 退 出 应 用 
( 按 回 退 键 或 结束 任务 ) ， 就 结束 ThumbnailDownloader 线 程 。 而 在 
用 户 旋 转 设 备 时 ， 不 销毁 重建 这 个 图 片 下 载 线程 一 一 应 对 设备 配置 改 
变 ， 保 留 线 程 实例 。 


我 们 知道 ， 一 个 ViewMode1l 的 生命 周期 是 和 其 关联 fragment 的 生命 周期 
同步 的 。 然 而 ， 在 PhotoGalleryViewModel 里 管理 线程 不 仅 实现 复 
杂 ， 还 可 能 会 引发 视图 内 存 泄 漏 。 因 此 ， 把 线程 管理 放 到 像 
FlickrFetchr 仓 库 这 样 的 组 件 里 会 更 合适 。 开 发 一 个 真实 应 用 时 ， 你 
很 可 能 就 会 这 么 做 。 但 这 里 ， 为 了 更 好 地 学 习 理 解 HandlerThread， 不 
能 这 么 做 。 


出 于 教学 需要 ， 本 章 要 把 ThumbnailDownloader 实 例 和 
PhotoGalleryFragment 绑 定 起 来 。 首 先 ， 保 

留 PhotoGalleryFragment， 让 和 它 和 用 户 看 得 到 的 fragment 的 生命 周期 
保持 一 致 ， 如 代码 清单 25-8 所 示 。 


代码 清单 25-8 m 
留 PhotoGalleryFragment (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


retainInstance - true 


| a 


(通常 情况 下 ， =e 要 保留 fragment。 这 里 ， 保 留 fragment 可 以 简化 
代码 实现 ， 让 你 聚焦 学 请 阅读 25.7 节 ， 
了 解 保 留 fragment 完 竟 意 味 着 什么 。 


保留 好 了 PhotoGalleryFragment， 接 下 来 实现 在 调 
FaPhotoGalleryFragment.onCreate(...) ŽUTI 5 
ThumbnailDownloader£EfZ, Ej 

用 PhotoGalleryFragment.onDestroy() 函 数 时 退出 。 你 可 能 会 说 ， 
这 很 简单 ， 直接 在 PhotoGalleryFragment 的 生命 8 周期 函数 里 添加 代码 
束 好 了 。 昌 然 是 个 办 法 ， 但 这 会 让 fragment 类 过 于 复杂 。 换 个 思路 ， 我 
们 可 以 增强 ThumbnailDownloader 的 功能 ， 把 它 打造 成 一 个 生命 nu RH 
感知 线程 。 


一 个 生命 周期 感知 组 件 ， 又 叫 生 命 周 期 观察 者 ， 能 够 观察 生命 周期 所 
有 者 的 生命 周期 。 Activity 和 Fragment 都 是 典型 的 生命 8 周期 所 有 者 
一 一 它们 有 生命 周期 ， 会 实现 LifecycleOwner 接 口 。 


如 代码 清单 25-9 所 示 ， 更 新 ThumbnailDownloader 类 ， 让 它 实现 
Lifecycle0bserver 接 口 ， 观 察 其 生命 周期 所 有 者 的 onCreate(...) 
和 onDestroy() 函 数 调用 。 在 onCreate(... ) 函 数 被 调用 时 启动 自 己 ， 
在 onDestroy() 函 数 被 调用 时 停止 。 


代码 清单 25-9 ”让 ThumbnailDownloader 感 知 生命 周期 
CThumbnailDownloader.kt ) 


private const val TAG = "ThumbnailDownloader" 


class ThumbnailDownloader«in T» 
: HandlerThread(TAG), LifecycleObserver ( 


private var hasQuit - false 
override fun quit(): Boolean { 


hasQuit - true 
return super.quit() 


QOnLifecycleEvent(Lifecycle.Event.ON CREATE) 
fun setup() { 

Log.i(TAG, "Starting background thread") 
} 


@OnLifecycleEvent(Lifecycle.Event.ON_DESTROY) 
fun tearDown() { 

Log.i(TAG, "Destroying background thread") 
} 


fun queueThumbnail(target: T, url: String) { 
Log.i(TAG, "Got a URL: $url") 


} 


实现 LifecycleObserver 接 口 后 ， 你 就 能 登记 ThumbnailDownloader 
接收 任何 Lifecycle0wner 的 生命 周期 回调 函数 了 。 使 用 
@OnLifecycleEvent(Lifecycle.Event) 注 解 可 以 把 某 个 函数 和 一 个 生命 周 
期 回调 函数 关联 起 来 。Lifecycle.Event.ON_CREATE 登 记 
ThumbnailDownloader.setup() 

在 LifecycleOwner .onCreate(...) 函 数 调用 时 调 

用 。Lifecycle.Event.ON_DESTROY 登 记 
ThumbnailDownloader.tearDown() 

在 LifecycleOwner .onDestroy() 函 数 调 用 时 调用 。 


可 以 查阅 API 参 考 手 册页 来 了 解 Lifecycle.Event 常 量 都 有 哪些 。 


(顺便 说 一 下 ，LifecycleObserver、Lifecycle.Event 和 和 
OnLifecycleEvent 在 Jetapck 库 的 android.arch.lifecycle 包 里 。 之 前 在 第 
24 章 ， 你 已 经 添加 过 1ifecycle-extensions 依 赖 ， 这 里 可 以 直接 使 
用 。) 


接 下 来 ， 在 PhotoGalleryFragmentk 里 ， 你 需要 创建 一 

个 ThumbnailDownloader 实 例 ， 注 册 自 己 接 

收 PhotoGalleryFragment 的 生命 周期 回调 函数 ， 如 代码 清单 25-10 所 
示 。 


代码 清单 25-10 ”创建 一 个 ThumbnailDownloader 实 例 
(PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private lateinit var photoGalleryViewModel: PhotoGalleryViewModel 
private lateinit var photoRecyclerView: RecyclerView 
private lateinit var thumbnailDownloader: ThumbnailDownloader<PhotoHold 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


retainInstance = true 


photoGalleryViewModel = 
ViewModelProviders.of(this).get(PhotoGalleryViewModel: :clas 


thumbnailDownloader = ThumbnailDownloader() 
lifecycle.addObserver(thumbnailDownloader) 


} 


override fun onViewCreated(view: View, savedInstanceState: Bundle?) { 


override fun onDestroy() { 
super.onDestroy() 
lifecycle.removeObserver( 
thumbnailDownloader 


ThumbnailDownloader 的 泛 型 参数 可 以 是 任何 类 型 。 然 而 ， 前 面 说 
过 ， 这 个 泛 型 参数 指定 的 对 象 将 被 用 来 标记 下 载 。 这 里 ，PhotoHolder 


最 合适 做 标记 ， 因 为 该 视图 是 最 终 显 示 下 载 图 片 的 地 方 。 


既然 Fragment 实 现 了 LifecycleOwner 接 口 ， 它 因此 会 有 一 

个 1ifecycle 属 性 。 你 可 以 用 这 个 属性 把 观察 者 添加 给 fragment 的 
Lifecycle. H lifecycle.addObserver (thumbnailDownloader) 
函数 就 能 登记 ThumbnailDown1loader 接 收 PhotoGalleryFragment 的 
生命 周期 回调 函数 。 现 在 ，PhotoGalleryFragment.onCreate(...) 
被 调用 时 ， 就 会 触发 ThumbnailDownloader.setup() 的 调 

用 。PhotoGalleryFragment.onDestroy() 被 调用 时 ， 束 会 触发 
ThumbnailDownloader.tearDown() 的 调用 。 


最 后 ， 在 fragment 实 例 被 销毁 时 ， 你 在 Fragment .onDestroy( ) 里 调 


Fulifecycle.removeObserver (thumbnailDownloader) eH A445 

束 thumbnailDownloader 的 观察 者 任务 。 你 也 可 以 依赖 垃圾 回收 机 
制 ， 在 垃圾 回收 器 释放 fragment (也 可 能 是 activity)〉 WAAAY, Faas 
除 生命 周期 观察 者 以 及 fragment 的 生命 周期 。 然 而 ， 相 比 让 垃圾 回收 器 
搜寻 ， 我 们 更 倾向 于 采用 确定 性 的 资源 释放 方式 。 这 样 ， 应 用 出 现 pug 
的 概率 就 会 小 一 些 。 


运行 PhotoGallery 应 用 。 你 看 到 的 应 该 还 是 满 屏 的 大 头 照 。 查 看 Logcat 窗 
口 找到 ThumbnailDownloader: Starting background thread 日 志 
输出 ， 以 此 确认 ThumbnailDownloader .setup() 函 数 执行 了 一 次 。 然 
后 ， 按 回 退 键 退 出 应 用 ， 结 束 使 用 PhotoGalleryActivity (包括 它 托 
管 的 PhotoGalleryFragment) 。 再 次 查看 Logcat 窗 口 找 

到 ThumbnailDownloader: Destroying background thread 日 志 输 
出 ， 以 此 确认 ThumbnailDownloader .tearDown() 执 行 了 一 次 。 


25.4.2” 启 停 HandlerThread 


既然 ThumbnailDownloader 时 刻 观察 着 PhotoGalleryFragment 的 生 
命 周 期 ， 那 么 现在 更 新 ThumbnailDownloader 类 ， 

在 PhotoGalleryFragment.onCreate(... ) 被 调用 时 ， 启 动 
ThumbnailDownloader 线 程 ; 

在 PhotoGalleryFragment .onDestroy() 被 调用 时 ， 停 止 自己 ， 如 代 
码 清单 25-11 所 示 。 


代码 清单 25-11 启 停 ThumbnailDownloader 线 程 
CThumbnailDownloader.kt ) 


class ThumbnailDownloader«in T» 
: HandlerThread(TAG), LifecycleObserver ( 


QOnLifecycleEvent(Lifecycle.Event.ON CREATE) 
fun setup() { 
Log.i(TAG, "Starting background thread") 
start() 
looper 


} 


QOnLifecycleEvent(Lifecycle.Event.ON DESTROY) 
fun tearDown() { 
Log.i(TAG, "Destroying background thread") 


quit() 
} 


fun queueThumbnail(target: T, url: String) { 
Log.i(TAG, "Got a URL: $url") 


} 


上 述 代 码 有 两 点 安全 考虑 值得 注意 。 首 先 ， 访 问 Looper〈 稍 后 会 学 
习 ) 是 在 调用 ThumbnailDownloader 的 start() 函 数 之 后 进行 的 。 这 
能 保证 线程 束 绪 ， 避 免 潜 在 竞争 〈 尽 管 极 少 发 生 ) 。 因 为 只 有 成 功 访问 
了 Looper， 才 能 保证 onLooperPrepared() 函 数 已 被 调用 。 这 

样 ，queueThumbnail(...) 函 数 因 空 Handler 而 调用 失败 的 情况 就 能 
避免 了 。 

其 次 ， 这 里 调用 quit() 函 数 终止 了 线程 。 这 非常 关键 。 假 如 不 终 
IEHandlerThread, CMA- HZI FH, MAME”. 


最 后 ， 在 PhotoAdapter.onBindviewHolder(...) 函 数 中 ， 调 用 线程 
的 queueThumbnail() 函 数 ， 并 传 入 放置 图 片 的 PhotoHolder 和 
GalleryItem 的 URL， 如 代码 清单 25-12 所 示 。 


代码 清单 25-12 关联 使 
用 ThumbnailDownloader (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


private inner class PhotoAdapter(private val galleryItems: List«Gallery| 
: RecyclerView.Adapter<PhotoHolder>() { 


override fun onBindViewHolder(holder: PhotoHolder, position: Int) { 
val galleryItem = galleryItems[ position] 


thumbnailDownloader.queueThumbnail(holder, galleryItem.ur1) 


运行 PhotoGallery 应 用 并 查看 LogCat 窗 口 。 在 RecyclerView 视 图 中 滑动 
时 ， 可 从 Logcat 窗 口 里 的 图 片 超 链接 线条 看 
出 ，ThumbnailDownloader 正 在 后 台 处 理 各 个 下 载 请 求 。 不 过 ， 你 现 


在 仍然 只 能 看 到 大 头 照 界面 〈 不 要 独 急 ， 稍 后 就 解决 ) 。 


成 功 创建 并 运行 HandlerThread 线 程 后 ， 接 下 来 ， 你 的 任务 是 让 应 用 主 
线程 和 刚刚 新 建 的 后 台 线 程 通信 。 


25.5 Message message handler 


虽然 我 们 打算 让 专用 线程 负责 下 载 图 片 ， 但 在 无 法 与 主线 程 直 接 通 信 的 
情况 下 ， 它 是 如 何 协同 RecyclerView 的 adapter 来 实现 图 片 显 示 的 呢 ? 
(之 前 我 们 说 过 ， 后 台 线 程 不 能 执行 更 新 视图 的 代码 一 一 主线 程 可 以 ; 
主线 程 不 能 执行 耗 时 任务 一 一 后 台 线 程 可 以 。) 


再 次 回 到 闪电 侠 与 鞋 店 的 假想 场景 。 后 台 工 作 的 闪电 侠 已 结束 与 分 销 商 
的 电话 沟通 。 他 需要 将 库存 已 找 回 的 消 恩 通知 给 前 台 内 电 侠 。 如 采 前 合 
闪电 侠 在 忙 ， 后 台 内 电 侠 就 不 能 打扰 他 。 于 是 ， 他 选择 登记 预约 ， 等 前 
台 闪 电 侠 空 亲 下 来 再 联系 。 这 方法 虽然 可 行 ， 但 效率 不 高 。 


比较 好 的 解决 方案 是 为 每 个 内 电 侠 提供 一 个 收 件 箱 。 后 合 内 电 侠 写 下 土 
己 入 库 的 信息 ， 并 将 其 放置 在 前 台 内 电 侠 的 收 件 箱 顶 部 。 前 台 内 电 侠 如 
需 告诉 后 台 内 电 侠 库存 已 空 的 信息 ， 也 可 以 这 样 做 。 


实践 证 明 ， 收 件 箱 的 办 法 非常 好 用 。 有 时， 闪电 侠 无论 是 哪 一 位 〉 可 
能 需要 尽快 完成 一 项 任务 ， 但 不 方便 立即 去 做 。 这 种 情况 下 ， 他 也 可 以 
在 目 己 的 收 件 箱 放 上 一 条 提醒 消 轧 ， 等 有 空 了 就 赶紧 处 理 。 


在 Android 系 统 中 ， 线 程 使 用 的 收 件 箱 叫 作 消 息 队 列 Cmessage 
queue) 。 使 用 消息 队列 的 线程 叫 作 消息 循环 (message loop) . WHA 
环 会 循环 检查 队列 上 是 否 有 新 消息 ， 如 图 25-2 所 示 。 


内 电 侠 1 


闪电 侠 2 
图 25-2 闪电 侠 之 舞 
消息 循环 由 线程 和 looper 组 成 。Looper 对 象 管理 着 线程 的 消息 队列 。 


主线 程 就 是 个 消 因 循环， 因此 也 拥有 looper。 主 线程 的 所 有 工作 都 是 由 
其 looper 完 成 的 。looper 不 断 从 消息 队列 中 抓 取 消息 ， 然 后 完成 消息 指定 
的 任务 ， 如 图 25-3 所 示 。 


Message N 


Message N-1 


Message 1 


MessageQueue 


图 25-3 ”主线 程 是 个 HandlerThread 


接 下 来 ， 我 们 将 创建 一 个 消息 循环 作为 后 台 线 程 。 准 备 需 要 的 Looper 
时 ， 我 们 会 使 用 一 个 名 为 HandlerThread 的 类 。 


使 用 Handler 往 对 方 消息 队列 里 放 消 息 ， 主 线程 和 后 台 线 程 会 互相 通 
信 ， 如 图 25-4 所 示 。 


Main thread ThumbnallDownloader 


Scroll event Download 


Bind ViewHolder Download 


Item click 


Looper  MessageQueue Looper  MessageQueue 


handleMessage|...) 


Handler 


图 25-4 使 用 Handler 通 信 


创建 消息 前 ， 首 先 要 理解 什么 是 Message， 以 及 它 与 Handler CX 
message handler) 之 间 的 关系 。 


25.5.1 训 析 Message 


首先 来 看 消息 。 内 电 侠 放 入 (自己 或 其 他 闪电 侠 〉 收 件 箱 的 消息 是 要 处 
理 的 各 种 任务 。“ 你 跑 得 真 快 ! "这样 的 或 励 消息 是 没 空 写 的 。 


消息 是 Message 类 的 一 个 实例 ， 它 有 好 几 个 实例 变量 ， 其 中 有 3 个 需要 


你 定义 。 


e What: 用 户 定义 的 Int 型 消息 代码 ， 用 来 描述 消息 。 
e obj: 用 户 指 定 ， 随 消息 发 送 的 对 象 。 
e target: 处 理 消息 的 Handler。 


Message 的 目标 (target) 是 一 个 Handler 类 实例 。Handler 可 看 作 
message handler 的 简称 。 创建 Message 时 ， 它 会 自动 与 一 个 Handler 相 
关联 。Message 待 处 理 时 ，Handler 对 象 负责 触发 消息 处 理事 件 。 


25.5.2 ”剖析 Handler 
要 处 理 消 息 以 及 消息 指定 的 任务 ， 首 先 需要 一 个 Handler 实 


例 。Handler 不 仅仅 是 处 理 Message 的 目标 (target) ， 也 是 创建 和 发 
布 Message 的 接口 ， 如 图 25-5 所 示 。 


MessageQueue 


| 
| 
1 
1 


图 25-5 Looper. Handler. HandlerThread^llMessage 


Looper 拥 有 Message 对 象 的 收 件 箱 ，Message 必 须 在 Looper 上 发 布 或 
处 理 。 既 然 有 这 层 关 系 ， 为 协同 工作 ，Handler 总 是 引用 Looper。 


一 个 Handler 仪 与 一 个 Looper 相 关联 ， 一 个 Message 也 仪 与 一 个 目 


标 Handler 〈 也 称 作 Message 目 标 ) 相关 联 。Looper 拥 有 整个 Message 
队列 。 多 个 Message 可 以 引用 同一 目标 Handler 〈 图 25-5) 。 


多 个 Handler 也 可 只 与 一 个 Looper 相 关联 ， 如 网 25-6 所 示 。 这 意味 着 一 
个 Handler 的 Message 可 能 与 男 一 个 Handler 的 Message 和 存放 在 同一 消 
ABA Im. 


MessageQueue 
Handler £1 


Handler #2 


Handler Z3 


1 
1 


1 
1 


HandlerThread 


125-6 ”多 个 Handler 对 应 一 个 Looper 

25.5.3 {E} handler 

一 般 来 讲 ， 不 应 手动 设置 消息 的 目标 Handler。 创 建 信息 时 ， 最 好 调 
用 Handler.obtainMessage(...) 函 数 。 传 入 其 他 必要 消息 字段 后 ， 
该 函数 会 目 动 设置 目标 Handler。 


为 避免 反复 创建 新 的 Message 对 象 ，Handler.obtainMessage(...) 函 
数 会 从 公共 回收 池 里 获取 消息 。 相 比 创建 新 实例 ， 这 样 更 加 高 效 。 

一 旦 取得 Message， 就 可 以 调用 sendToTarget() 函 数 将 其 发 送 给 它 的 
Handler。 然 后 ，Handler 会 将 这 个 Message 放 置 在 Looper 消 息 队 列 的 
尾部 。 


对 于 PhotoGallery 应 用 ， 我 们 会 在 queueThumbnail() 实 现 函数 中 获取 并 


发 送 消息 给 它 的 目标 。 消 息 的 what 属 性 是 一 个 定义 

为 MESSAGE_DOWNLOAD 的 常量 。 消 恩 的 obj 属 性 是 一 个 T 类 型 对 象 ， 这 里 
指 由 adapter 传 入 queueThumbnail() 函 数 的 PhotoHolder， 用 于 标识 下 
载 。 


Looper 取 得 消息 队列 中 的 特定 消息 后 ， 会 将 它 发 送 给 消息 的 目标 
Handler 去 处 理 。 消 息 一 般 是 在 目标 Handler 的 
Handler.handleMessage(...) 实 现 函 数 中 进行 处 理 的 。 


图 25-7 展 示 了 其 中 的 对 象 关系 。 


MessageQueue MessageQueue 


My Handler 


My Handler 


HandlerThread 


HandlerThread HandlerThread 


图 25-7 创建 并 发 送 Message 
这 里 ， 稍 后 要 创建 的 handleMessage(...) 实 现 函 数 将 使 


用 FlickrFetchr 从 URL 下 载 图 片 字 节 数 据 ， 然 后 再 转换 为 位 图 。 


开始 写实 现代 码 。 首 先 添加 一 些 常 量 和 成 员 变 量 ， 如 代码 消 单 25-13 所 
示 。 


代码 清单 25-13 ”添加 一 些 常 量 和 成 员 变 
( ThumbnailDownloader.kt ) 


Rn 


private const val TAG = "ThumbnailDownloader" 
private const val MESSAGE DOWNLOAD = 6 


class ThumbnailDownloader«in T» 
: HandlerThread(TAG), LifecycleObserver ( 


private var hasQuit - false 

private lateinit var requestHandler: Handler 

private val requestMap = ConcurrentHashMap«T, String>() 
private val flickrFetchr = FlickrFetchr() 


MESSAGE_DOWNLOAD 用 来 标识 下 载 请 求 消息 。 
(ThumbnailDownloader 会 把 它 设 为 任何 新 创建 下 载 消 息 的 what 属 
性 。) 


新 洪 加 的 requestHandler 用 来 存储 对 Handler 的 引用 。 这 个 Handler 
负责 在 ThumbnailDownloader 后 台 线 程 上 管理 下 载 请 求 消息 队列 。 还 
负责 从 消息 队列 里 取出 并 处 理 下 载 请 求 消息 。 


新 添加 的 requestMap 是 个 ConcurrentHashMap。 这 是 一 种 线程 安全 的 
HashMap。 这 里 ， 使 用 一 个 标记 下 载 请 求 的 T 类 型 对 象 作为 key， 我 们 可 
以 存 取 和 请 求 关联 的 URL 下 载 链接 。 (这 个 标记 对 象 是 PhotoHolder， 
下 载 结果 就 能 很 方便 地 发 送 给 显示 图 片 的 UI 元 素 。) 


新 添加 的 flickrFetchr 属 性 会 存储 对 FLickrFetchr 实 例 的 引用 。 这 
样 ， 所 有 的 Retrofit 配 置 代码 在 线程 生命 周期 里 只 会 执行 一 ~ (发 起 一 
个 网 络 请 求 就 创建 并 配置 一 个 Retrofit 新 实例 会 拖 慢 应 用 。 


接 下 来 ， 在 queueThumbnail(...) 函 数 中 添加 代码 ， 更 新 requestMap 
并 把 下 载 消息 放 到 后 台 线 程 的 消息 队列 中 去 ， 如 代码 清单 25-14 所 示 。 


代码 清单 25-14 ”获取 和 发 送 消息 CThumbnailDownloader.kt 


class ThumbnailDownloader<in T> 
: HandlerThread(TAG), LifecycleObserver { 


fun queueThumbnail(target: T, url: String) { 
Log.i(TAG, "Got a URL: $url") 
requestMap[target] = url 
requestHandler.obtainMessage(MESSAGE DOWNLOAD, target) 
.sendToTarget() 


从 requestHandler 直 接 获 取消 息 后 ，requestHandler 也 就 自动 成 了 
这 个 新 Message 对 象 的 target。 这 表明 requestHandler 会 负责 处 理 从 
消息 队列 中 取出 的 这 个 消息 。 这 个 消 恩 的 what 属 性 

是 MESSAGE_DOWNLOAD。 它 的 obj 属 性 是 传递 给 queueThumbnail(...) 
函数 的 T target 值 (这 里 指 PhotoHolder) . 


新 消息 就 代表 指定 为 T target (RecyclerView 中 的 PhotoHolder) 的 
下 载 请 求 。 还 记得 吗 ? 在 PhotoGalleryFragment 中 ，RecyclerView 
的 adapter 就 是 从 onBindViewHolder(...) 函 数 里 调 

用 queueThumbnail(...)， 把 待 下 载 图 片 及 其 URL 传 给 PhotoHolder 
的 。 


注意 ， 消 息 自身 不 包 仿 URL 信息。 我 们 的 做 法 是 使 用 PhotoHolder 和 
URL 的 对 应 关系 更 新 requestMap。 随 后 ， 我 们 会 从 requestMap 中 取出 
图 片 URL， 以 保证 总 是 使 用 了 匹配 PhotoHolder 实 例 的 最 新 下 载 请 求 
URL. (这 很 重要 ， 因 为 RecyclerView 中 的 ViewHolder 会 不 断 回收 重 
用 。) 


最 后 ， 初 始 化 requestHandler 并 定义 该 Handler 在 得 到 消息 队列 中 的 
下 载 消息 后 应 执行 的 任务 ， 如 代码 清单 25-15 所 示 。 


代码 清单 25-15 ”处理 消息 CThumbnailDownloader.kt ) 


class ThumbnailDownloader<in T> 
: HandlerThread(TAG), LifecycleObserver { 


private val requestMap = ConcurrentHashMap<T, String>() 
private val flickrFetchr = FlickrFetchr() 


@Suppress("UNCHECKED_CAST" ) 
@SuppressLint("HandlerLeak" ) 
override fun onLooperPrepared() { 
requestHandler = object : Handler() { 
override fun handleMessage(msg: Message) { 
if (msg.what == MESSAGE_DOWNLOAD) { 
val target = msg.obj as T 
Log.i(TAG, "Got a request for URL: ${requestMap[target ] 
handleRequest(target ) 


fun queueThumbnail(target: T, url: String) { 


} 


private fun handleRequest(target: T) { 
val url = requestMap[target] ?: return 
val bitmap = flickrFetchr.fetchPhoto(url) ?: return 


导入 Message 类 时 ， 确 认 选 择 android.os.Message 包 。 


上 述 代 码 中 ， 我 们 是 在 onLooperPrepared() 函 数 里 实现 
Handler.handleMessage(...) 函 数 

的 。HandlerThread . onLooperprepared() 在 Looper 首 次 检查 消息 队 
列 之 前 调用 ， 所 以 该 函数 是 创建 Handler 实 现 的 好 地 方 。 


在 Handler.handleMessage(...) 函 数 中 ， 首 先 检查 消息 类 型 ， 再 获 
取 obj 值 (T 类 型 下 载 请 求 )， 然 后 将 其 传递 给 handleRequest(...) 耳 
数 处 理 。〔 前 面 说 过 ， 队 列 中 的 下 载 消息 取出 并 可 以 处 理 时 ， 就 会 触发 
调用 Handler.handleMessage(...) 函 数 。) 


handleRequest() 函 数 是 下 载 执 行 的 地 方 。 在 这 里 ， 确 认 URL 有 效 
后 ， 束 将 它 传 递 给 本 章 一 开始 就 创建 的 
FlickrFetchr.fetchPhoto(...) 函 数 。 


@Suppress("UNCHECKED_CAST") 注 解 告 诉 Lint 检 查 器 ， 这 里 不 用 做 类 
型 匹配 检查 了 ， 你 确认 可 以 直接 把 msg .obj 强 制 类 型 转换 为 T7。 因 为 就 


你 一 人 在 开 及 PhotoGallery 代 码 ， 所 以 你 很 蔚 定 。 你 负责 把 消息 添加 到 
队列 里 ， 并 且 知 道 当 前 放 入 队列 里 的 消息 都 有 obj 字 段 且 持 

有 PhotoHolder 实 例 (肯定 和 ThumbnailDownloader 指 定 的 T 类 型 匹 
配 ) 。 


从 技术 实现 来 看 ， 创 建 Handler 实 现 也 创建 了 一 个 内 部 类 。 内 部 类 天 然 
持 有 外 部 类 (这 里 指 ThumbnailDownloader 类 ) 的 实例 引用 。 这 样 一 
来 ， 如 果 内 部 类 的 生命 周期 比 外 部 类 长 ， 就 会 出 现 外 部 类 的 内 存 泄漏 问 


je 


不 过 ， 只 有 在 把 Handler 添 加 给 主线 程 的 looper 时 才 会 有 此 问题 。 这 里 ， 
使 用 @SuppressLint("HandlerLeak") 的 作用 是 不 让 Lint 报 警 ， 因 为 此 处 创 
建 的 Handler 是 添加 给 后 台 线 程 的 looper 的 。 如 果 把 你 创建 的 Handler 添 加 
给 主线 程 的 looper， 那 么 它 就 不 会 被 垃圾 回收 ， 自 然 就 会 内 存 泄漏 ， 进 
而 导致 它 引 用 的 ThumbnailDownloader 实 例 也 引发 内 存 泄漏 问题 。 


总 之 ， 不 要 轻易 强行 屏 散 Lint 警 告 ， 除 非 你 真正 理解 Lint 发 出 的 警告 ， 
且 知 道 这 么 做 很 安全 。 


运行 PhotoGallery 应 用 ， 通 过 LogCat 窗 口 的 日 志 确 认 代 码 工 作 正 常 。 


当然 ， 在 将 位 图 设置 给 PhotoHolder 视 图 (来 自 PhotoAdapter) 之 
前 ， 请 求 处 理 还 不 算 完 。 不 过 这 是 UI 的 工作 。 因 此 ， 必 须 回 到 主线 程 上 
完成 它 。 


目前 为 止 ， 所 有 的 工作 就 是 在 线程 上 使 用 handler 和 消息 
一 一 ThumbnailDownloader 把 消息 放 入 目 己 的 收 件 箱 。 下 一 节 要 学 习 
的 内 容 是 : ThumbnailDownloader 如 何 使 用 Handler 向 主线 程 发 请 


25.5.4 传递 handler 


当前 ， 使 用 ThumbnailDownloader 的 requestHandler， 我 们 已 可 以 从 
主线 程 安排 后 台 线 程 任务 ， 如 图 25-8 所 示 。 


“下 载 该 图 片 ! ” 


requestHandler 


图 25-8 ”自主 线程 安排 ThumbnailDownloader 上 的 任务 


反 过 来 ， 也 可 以 从 后 台 线 程 使 用 与 主线 程 关 联 的 Handler， 安 排 主 线程 
任务 ， 如 图 25-9 所 示 。 


“完成 了 ! 现在 去 
设置 该 ImageView 
上 的 图 片 ” 

一 一 一 一 一 一 ThumbnailDownloader 


a responseHandler 


图 25-9 从 ThumbnailDown1loader 线 程 上 规划 主线 程 任务 


requestHandler 


主线 程 是 一 个 拥有 handler 和 Looper 的 消息 循环 。 主 线程 上 创建 的 

Handler 会 自动 与 它 的 Looper 相 关联 。 主 线程 上 创建 的 Handler 也 可 以 
传递 给 另 一 线程 。 传 递 出 去 的 Handler 与 创建 它 的 线程 Looper 始 终 保持 
者 联系 。 因 此 ， 已 传 出 Handler 负 责 处 理 的 所 有 消息 都 将 在 主线 程 的 消 


县 队列 中 处 理 。 


在 ThumbnailDownloader.kt 中 ， 添 加 图 25-9 中 的 responseHandler 属 

性 ， 用 来 存放 来 自主 线程 的 Handler。 然 后 ， 以 一 个 能 接受 Handler 的 
构造 函数 蔡 换 原 构 造 函 数 。 新 构造 函数 的 另 一 个 参数 是 个 函数 类 型 ， 作 
为 函数 回调 把 消息 反 饿 〈 下 载 的 图 片 ) 通知 给 请 求 者 〈 主 线程 )》 ， 如 代 
码 清 单 25-16 所 示 。 


代码 清单 25-16 is 


加 responseHandler (ThumbnailDownloader.kt) 


class ThumbnailDownloader<in T>( 
private val responseHandler: Handler, 
private val onThumbnailDownloaded: (T, Bitmap) -> Unit 


) : HandlerThread(TAG), LifecycleObserver { 


} 


在 图 片 下 载 完 成 并 可 以 交 给 UI 去 显示 时 ， 定 义 在 新 构造 函数 中 的 函数 类 
型 属性 就 会 被 调用 。 稍 后 ， 为 了 把 下 载 任务 和 UI 更 新 任务 〈 把 图 片 放 
入 ImageView) 分 开 ， 取 代 ThumbnailDownloader， 我 们 使 用 这 个 监 
听 器 把 处 理 已 下 载 图 片 的 任务 委托 给 另 一 个 类 〈 这 里 

指 PhotoGalleryFragment) 。 这 样 ，ThumbnailDownloader 就 可 以 
把 下 载 结果 传 给 其 他 视图 对 象 了 。 


接 下 来 ， 修 改 PhotoGalleryFragment 类 ， 将 主线 程 关 联 的 Handler 传 
递 给 ThumbnailDownloader。 另 外 ， 再 传递 一 个 匿名 函数 处 理 已 下 载 
图 片 ， 如 代码 清单 25-17 所 示 。 


代码 清单 25-17 使 用 消息 反馈 
Handler (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 


— &unbniiibeunienden-o Fhuhbneiiboknioader O 


val responseHandler = Handler() 


thumbnailDownloader = 
ThumbnailDownloader(responseHandler) { photoHolder, bitmap 
val drawable = BitmapDrawable(resources, bitmap) 
photoHolder.bindDrawable(drawable) 


lifecycle.addObserver(thumbnailDownloader) 


前 面 说 过 ，Handler 默 认 与 当前 线程 的 Looper 相 关联 。 这 个 Handler 是 


在 onCreate(...) 函 数 中 创建 的 ， 它 会 与 主线 程 的 Looper 相 关联 。 


现在 ， 通 过 responseHandler，ThumbnailDown1loader 能 够 使 用 与 主 
线程 Looper 绑 定 的 Handler。 同 时 ， 还 有 函数 类 型 实现 使 用 返回 的 
Bitmap 执 行 UI 更 新 操作 。 有 具体 来 说 ， 束 是 传 给 
onThumbnailDownloaded itz 数 的 函数 会 使 用 新 下 载 的 Bitmap 来 设 
置 PhotoHolder 的 Drawable。 


和 在 后 台 线 程 上 把 图 片 下 载 请 求 放 入 消息 队列 类 似 ， 我 们 也 可 以 发 送 定 
制 Message 给 主线 程 ， 要 求 显 示 已 下 载 图 片 。 不 过 ， 这 需要 另 一 
“Handler $28, bAA—~ShandleMessage(...) 72 mi AŽ 


方便 起 见 ， 我 们 改 用 另 一 个 Handler 函 数 一 post (Runnable). 


Handler.post(Runnable) 是 一 个 发 布 Message 的 便利 函数 。 示 例如 
F: 


myRunnable: Runnable = object : Runnable { 
override fun run() { 
// Your code here 


} 


} 
var msg: Message = Message.obtain(someHandler, myRunnable) 
// Sets msg.callback to myRunnable 


Message 设 有 回调 函数 属性 后 ， 取 出 队列 的 消息 是 不 会 发 给 target 
Manoir TH; 存储 在 回调 函数 中 的 Runnable 的 run() 函 数 会 直接 
pu 


在 ThumbnailDownloader.handleRequest() 函 数 中 ， 使 


用 responseHandler 把 Runnable 放 入 主线 程 队 列 ， 如 代码 清单 25-18 所 
Ze 


代码 清单 25-18 图 片 下 载 与 显示 CThumbnailDownloader.kt) 


class ThumbnailDownloader<in T>( 
private val responseHandler: Handler, 
private val onThumbnailDownloaded: (T, Bitmap) -> Unit 
: HandlerThread(TAG), LifecycleObserver { 


private fun handleRequest(target: T) { 
val url = requestMap[target] ?: return 
val bitmap = flickrFetchr.fetchPhoto(url) ?: return 


responseHandler.post(Runnable { 
if (requestMap[target] != url || hasQuit) { 
return@Runnable 


} 


requestMap.remove(target ) 
onThumbnailDownloaded(target, bitmap) 


因为 responseHandler 与 主线 程 的 Looper 相 关联 ， 所 以 UI 更 新 代码 会 
在 主线 程 中 完成 。 


那么 上 述 代 码 有 什么 作用 呢 ? 首先 ， 它 会 再 次 检查 requestMap。 这 很 

有 必要 ， 因 为 RecyclerView 会 循环 使 用 其 视图 。 

在 ThumbnailDownloader 下 载 完 成 Bitmap 之 后 ，RecyclerView 可 能 

循环 使 用 了 PhotoHolder 并 相应 请 求 了 一 个 不 同 的 URL。 该 检查 可 保证 
Serer re eee 即使 中 间 发 生 了 其 他 请 求 也 


接 下 来 ， 检 查 hasQuit 值 。 如 果 ThumbnailDownloader 已 经 退出 ， 那 
么 运行 任何 回调 函数 可 能 都 不 太 安 全 。 


最 后 ， 从 requestMap 中 删除 配对 的 PhotoHolder-URL， 然 后 将 位 图 设 
置 到 目标 PhotoHolder 上。 


25.6 ”观察 视图 的 生命 周期 


在 运行 应 用 并 欣赏 图 片 前 ， 还 应 考虑 一 个 风险 点 。 如 果 用 户 旋转 屏幕 ， 
因 PhotoHolder 视 图 的 失效 ，ThumbnailDownloader 可 能 会 挂 起 。 此 
时 Thumbnai1lDownloader 还 要 发 送 图 片 给 已 销毁 的 PhotoHolder 会 让 
MH AK o 


要 解雇 这 个 问题 ， 需 要 在 fragment 的 视图 被 销毁 时 ， 清 除 下 载 队 列 中 的 
所 有 请 求 。 这 需要 ThumbnailDownloader 掌 握 fragment 视 图 的 生命 周 
期 。 (之 前 说 过 ，fragment 的 生命 周期 和 fragment 视 图 的 生命 周期 是 不 
同 的 。 既 然 你 选择 保留 fagment， 那 么 设备 旋转 会 销毁 fragment 的 视 
图 ， 但 fragment 实 例 自 映 还 在 。) 


首先 ， 为 添加 第 二 个 生命 周期 观察 者 实现 ， 重 构 fragment 生 命 周 期 观 家 
者 代码 ， 如 代码 清单 25-19 所 示 。 


代码 清单 25-19 重 构 fragment 生 命 周期 观察 者 代码 实现 
CThumbnailDownloader.kt ) 


class ThumbnailDownloader<in T>( 

private val responseHandler: Handler, 

private val onThumbnailDownloaded: (T, Bitmap) -> Unit 
) : HandlerThread (TAG) 


—;_tifeeyeleObserver 
zu 
val fragmentLifecycleObserver: LifecycleObserver = 
object : LifecycleObserver ( 


QOnLifecycleEvent(Lifecycle.Event.ON CREATE) 
fun setup() 1 
Log.i(TAG, "Starting background thread") 
start() 
looper 


} 


QOnLifecycleEvent(Lifecycle.Event.ON DESTROY) 
fun tearDown() { 
Log.i(TAG, "Destroying background thread") 
quit() 


} 


private var hasQuit = false 


—@0ntifecycleEvent(tifecyete-Event-ONCREATE) 
——fun-setupO-t 

EDU 

E 

——fun-tearBown O-4 

— eg-i(TAG; —Background—thread-destroyed") 
EG 

ES 

} 


接 下 来 ， 定 义 一 个 新 的 观察 者 ， 啊 应 fragment 视 图 的 生命 周期 回调 事 
件 ， 如 代码 清单 25-20 所 示 。 


代码 清单 25-20 添加 一 个 视图 生命 周期 观察 者 
( ThumbnailDownloader.kt ) 


class ThumbnailDownloader<in T>( 
private val responseHandler: Handler, 
private val onThumbnailDownloaded: (T, Bitmap) -> Unit 
: HandlerThread(TAG) ( 


val fragmentLifecycleObserver: LifecycleObserver - 
object : LifecycleObserver { 


} 


val viewLifecycleObserver: LifecycleObserver = 
object : LifecycleObserver { 


QOnLifecycleEvent(Lifecycle.Event.ON DESTROY) 

fun clearQueue() ( 
Log.i(TAG, "Clearing all requests from queue") 
requestHandler.removeMessages (MESSAGE DOWNLOAD) 
requestMap.clear() 


这 里 ， 在 观察 fragment 视 图 的 生命 周期 

时 ，Lifecycle.Event.ON_DESTROY 对 应 

着 Fragment .onDestroyView() 函 数 。 nA TEL fragment a 
周期 回调 对 应 的 Lifecycle.Event 常 量 ， 可 查看 Fragment API 参 考 手册 
的 getViewLifecycleOwner。) 


现在 ， 更 新 PhotoGalleryFragment， 登 记 刚 重 构 的 fragment 观 察 者 。 
另外 ， 登 记 刚 新 加 的 生命 周期 观察 者 观察 fragment 视 图 的 生命 周期 ， 如 
代码 清单 25-21 所 示 。 


代码 清单 25-21 登记 视图 生命 周期 观察 者 
(PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 


thumbnailDownloader = 
ThumbnailDownloader(responseHandler) { 


} 


lifecycle.addObserver(thumbnailDownloader.fragmentLifecycleObserver 


} 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View { 
viewLifecycleOwner.lifecycle.addObserver( 
thumbnailDownloader.viewLifecycleObserver 


只 需 在 onCreateView(...) 函 数 的 末尾 返回 一 个 非 空 视图 ， 你 即 可 以 
安全 地 在 Fragment.onCreateView(...) 函 数 里 观察 视图 的 生命 周 

期 。 阅 读 25.10 贡 的 挑战 练习 ， 可 以 学 到 更 多 有 关 VviewLifecycle0wner 
观察 的 知识 。 在 配置 视图 生命 周期 观察 时 ， 更 为 灵活 的 方式 是 观察 视图 


的 viewLifecycleOwner。 


最 后 ， 在 Fragment.onDestroyView() 函 数 里 ， 移 

除 thumbnailDownloader 这 个 fragment 视 图 生命 周期 观察 者 。 同 时 ， 
之 前 的 代码 重 构 ， 还 需 移 除 thumbnailDownloader 的 fragment 生 命 周期 
观察 者 ， 如 代码 清单 25-22 所 示 。 


代码 清单 25-22 删除 视图 生命 周期 观察 者 
(PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


override fun onDestroyView() { 
super. onDestroyView( ) 
viewLifecycleOwner.lifecycle.removeObserver( 


thumbnailDownloader.viewLifecycleObserver 
) 
} 


override fun onDestroy() { 
super.onDestroy() 
lifecycle.removeObserver( 
thumbnailDownloader.fragmentLifecycleObserver 


和 对 待 fragment 生命 周期 观察 者 一 样 ， 你 可 以 不 去 手动 移 除 fragment 的 
viewLifecycleOwner. 1ifecycle 观 察 者 。 fragment 视 图 生命 周期 登记 
处 管理 着 所 有 视图 生命 周期 管理 者 ，fragmetn 的 视图 不 存在 了 ， 
fragment 视 图 生命 周期 登记 处 也 会 随 之 失效 。 不 过 ， 和 之 前 一 样 ， 我 们 
更 喜欢 手动 做 资源 清理 工作 。 


至 些 ， 本 章 的 所 有 任务 都 完成 了 。 运 行 PhotoGallery 应 用 ， 演 动 屏幕 查 
看 图 片 的 动态 加 载 ， 如 图 25-10 所 示 。 


9:00 MAUD d 


PhotoGallery 


图 25-10 ”显示 Elickr 图 片 


PhotoGallery 应 用 有 了 下 载 并 显示 图 片 的 基本 功能 。 接 下 来 的 几 章 还 会 
为 应 用 添加 更 多 功能 ， 比 如 搜索 图 片 、 在 Web 视 图 中 打开 图 片 所 在 的 
Flickr 网 页 等 。 


25.7 ”保留 fragment 


fragment 的 retainInstance 属 性 值 默认 为 false， 这 表明 其 不 会 被 保 
留 。 因 此 ， 设 备 旋转 时 ，fragment 会 随 托管 activity 一 起 被 销毁 并 重建 。 
调用 setRetainInstance(true) 函 数 可 保留 fragment。 已 保留 的 
fragment 不 会 随 activity 一 起 被 销毁 。 相 反 ， 它 会 一 直 保留 ， 并 在 需要 时 
原封 不 动 地 转 给 新 的 activity。 


对 于 已 保留 的 fragment 实 例 ， 其 全 部 实例 变量 的 值 也 会 保持 不 变 ， 因 此 
可 放心 继续 使 用 。 


25.7.1 设备 旋转 与 保留 fragment 


现在 ， 我 们 来 看 看 保留 fragment 的 工作 原理 。fragment 之 所 以 能 保留 ， 
是 因为 这 样 一 个 事实 : 可 以 销毁 和 重建 fragment 的 视 网 ， 但 fragment 目 
号 可 以 不 被 销毁 。 


设备 配置 发 生 改 变 时 ，FragmentManager 首 先 销毁 队列 中 fragment 的 视 
图 。 在 设备 配置 改变 时 ， 总 是 销毁 与 重建 fragment 与 activity 的 视图 ， 都 
是 基于 同样 的 理由 : 新 的 配置 可 能 需要 新 的 资源 来 由 配 ， 当 有 更 合适 的 
资源 可 用 时 ， 则 应 重建 视图 。 


紧 接 着 ，FragmentManager 检 查 每 个 fragment 的 retainInstance 属 性 
值 。 如 果 属 性 值 为 false (初始 默认 值 )FragmentManager 会 立即 销毁 
该 fragment 实 例 。 随 后 ， 为 了 适应 新 的 设备 配置 ， 新 activity 的 新 

FragmentManager 会 创建 一 个 新 的 fragment 及 其 视图 ， 如 图 25-11 所 示 。 


旋转 之 前 旋转 之 后 


"AG New 
MainActivity MainActivity 
New 
FragmentManager FragmentManager 


New 
PhotoGalleryFragment 


, New 
RecyclerView RecyclerView 


图 25-11 设备 旋转 前 后 (UI fragment 默 认 不 保留 ) 


PhotoGalleryFragment 


d 


如 果 属 性 值 为 true， 则 该 fragment 的 视图 立即 被 销毁 ， 但 fragment 本 喘 
不 会 被 销毁 。 为 了 适应 新 的 设备 配置 ， 新 activity 创 建 后 ， 新 
FragmentManager 会 找到 已 保留 的 fragment， 并 重新 创建 它 的 视图 ， 如 图 
25-12 上 所 示 。 
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图 25-12 设备 旋转 与 已 保留 的 UI fragment 


虽然 已 保留 的 fragment 没 有 被 销毁 ， 但 它 已 脱离 消亡 中 的 activity 并 处 于 
保留 状态 。 尽 管 此 时 的 fragment 还 在 ， 但 已 没有 任何 activity 托 管 它 ， 如 


图 25-13 所 示 。 
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图 25-13 ”Fragment 牛 命 周 期 
必须 同时 满足 两 个 条 件 ，fragment 才 能 进入 保留 状态 : 


e 已 调用 了 fragment 的 setRetainInstance(true) 函 数 ; 
。 因 设 备 配 置 改变 (通常 为 设备 旋转 ) ， 托 管 activity 正 在 被 销毁 。 


fragment 只 能 保留 非常 短 的 时 间 一 一 从 脱离 旧 activity 到 重新 附加 给 立即 
新 建 的 activity 之 间 的 一 段 时 间 。 


25.7.2 是否 保留 fragment 


保留 fragment 可 以 说 是 Android 的 一 处 巧妙 设计 ， 不 是 吗 ? 没 错 ! 这 似乎 
解决 了 因 设 备 旋转 而 销毁 activity 和 fragment 所 导致 的 全 部 问题 。 现 在 ， 

如 果 设 备 配 置 有 变 ， 可 以 创建 全 新 视图 获取 最 合适 的 资源 ， 也 可 以 轻松 
保留 原 有 数据 及 对 象 。 


你 可 能 会 疑惑 : 为 什么 不 保留 所 有 fragment? 为 什么 fragment 的 
retainInstance 默 认 属 性 值 不 是 true? 这 是 因为 ， 除 非 万 不 得 已 ， 最 
好 不 要 使 用 这 种 机 制 。 理 由 如 下 。 


首先 ， 相 比 非 保留 fagment， 已 保留 fragment 用 起 来 更 复杂 。 一 旦 出 现 
问题 ， 问 题 排查 非常 耗 时 。 既 然 它 会 让 程序 变 得 复杂 ， 能 不 用 就 不 用 
吧 。 


其 次 ，fragment 在 使 用 保存 实例 状态 的 方式 处 理 设 备 旋转 时 ， 也 能 够 应 
对 所 有 生命 周期 场景 ， 但 保留 的 fragment 只 能 应 付 activity 因 设备 旋转 而 
被 销毁 的 情况 。 如 有 果 activity 是 因 系 统 回 收 内 存 而 被 销毁 ， 则 所 有 保留 的 
fragment 也 会 随 之 被 销毁 ， 数 据 也 就 跟着 丢失 了 。 


最 后 ， 大 多 数 情 况 下 ， 有 了 ViewMode1 就 不 需要 保留 fagment 了 。 为 应 
对 设备 配置 改变 ， 应 尽量 使 用 ViewMode1 而 不 是 保留 fragment 来 保存 UI 
状态 。 同 样 是 应 对 设备 配置 改变 ，ViewMode1l 不 仅 能 保存 UI 状态 数据 ， 
还 能 元 服 保留 ffagment 引 起 的 过 于 复杂 的 fragment 生 命 周 期 管理 。 


25.8 深入 学 习 : 解决 图 片 下 载 问题 


本 书 教学 使 用 的 都 是 Android 官 方 库 中 的 工具 。 你 也 可 以 考虑 用 各 种 第 
三 方 库 。 这 些 库 专用 于 一 些 特定 场景 (比如 PhotoGallery 中 的 图 片 下 
载 ) ， 可 以 节约 大 量 开发 时 间 。 


必须 承认 ，PhotoGallery 应 用 的 图 片 下 载 实现 远 不 够 完美 。 如 果 还 想 优 
化 性 能 ， 实 现 埋 手 的 缓存 功能 ， 很 自然 就 会 想到 是 否 询 人 已 有 更 好 的 解 
决 方案 。 管 案 是 肯定 的 。 有 好 几 个 高 性 能 图 片 下 载 库 可 供 选 择 。 例 如 ， 
在 开发 生产 应 用 时 ， 我 们 就 用 了 Picasso 库 。 


使 用 Picasso 库 ， 只 需 调 用 几 个 函数 就 能 实现 本 章 的 图 片 下 载 功能 : 


private class PhotoHolder(private val itemImageView: ImageView) 
: RecyclerView.ViewHolder(itemView) { 


fun bindGalleryItem(galleryItem: GalleryItem) { 
Picasso.get() 
.load(galleryItem.url) 
.placeholder(R.drawable.bill up close) 
.into(itemImageView) 


上 述 代 码 中 ， 流 接口 需要 使 用 get() 得 到 一 个 Picasso 实 

fil. load(String)H Tia FRR INURL. into(ImageView) H 
于 指定 加 载 下 载 结果 的 ImageView 对 象 。 当 然 ， 还 有 一 些 其 他 配置 选项 
可 用 ， 比 如 在 图 片 下 载 下 来 之 前 指定 占 位 图 厂 ( 使 

用 placeholder(Int) 和 placeholder(drawable))。 


在 PhotoAdapter.onBindViewHolder(...) 函 数 中 ， 只 要 调 
FabindGalleryItem(...) PK, mihe EMEAK RRE. 


Picasso} 7} f ThumbnailDownloader (还 

^H ThumbnailDownloader. ThumbnailDownloadListener<T> |=] iil rf 
数 ) 的 所 有 工作 以 及 FlickrFetchr 中 的 图 片 处 理 相 关 工 作 ， 所 以 可 以 
直接 删除 ThumbnailDownloader 实 现 (FlickrFetchr 中 的 JSON 数 据 
下 载 还 是 需要 的 ) 。 使 用 Picasso， 不 仅 能 简化 代码 ， 还 能 轻松 使 用 它 的 
图 片 动画 、 磁 盘 绥 存 等 高 级 特性 。 


你 可 以 在 项 目 结构 窗口 中 将 Picasso 作 为 库 依 赖 项 添加 在 项 目 中 ， 就 像 添 
加 RecyclerView 等 其 他 依赖 项 一 样 。 


当然 ，Picasso 也 不 是 万 能 的 ， 为 追求 小 而 美 ， 它 也 有 功能 取舍 ， 比 如 ， 
它 不 支持 下 载 动态 图 片 。 如 果 你 有 这 个 需求 ， 可 以 考虑 使 用 Google 的 
Glide 库 或 Facebook 的 Fresco 库 。 这 两 个 各 有 特点 ，Glide 比 较 小 巧 ， 
Fresco 性 能 好 。 


25.9 ”深入 学 习 : StrictMode 


开发 Android 应 用 时 ， 有 些 东 西 最 好 要 避免 ， 比 如， 让 应 用 崩 尝 的 代码 
漏洞 、 安 全 漏洞 等 。 例 如 ， 网 络 条 件 不 好 的 情况 下 ， 在 主线 程 上 友 送 网 
络 请 求 大 概 京 会 导致 设备 出 现 ANR 错 误 。 


如 果 表 现在 后 台 ， 你 应 该 会 看 到 NetworkonMainThread 异 常 以 及 其 他 
大 量 日 志 信 息 。 这 实际 是 StrictMode 针 对 错误 提出 的 警告。Android 引 入 
了 StrictMode 以 帮助 开发 者 探测 代码 问题 。 像 在 主线 程 上 发 起 网 络 请 
求 、 编 码 漏洞 以 及 安全 漏洞 这 样 的 问题 都 是 它 探测 的 对 象 。 


无 须 任 何 配置 ，StrictMode 就 会 阻止 在 主线 程 上 发 起 网 络 请 求 这 样 的 
代码 问题 。 它 还 能 探测 影响 系统 性 能 的 代码 问题 。 如 果 想 启 

用 strictMode 默 认 防 御 策 略 ， 调 用 StrictMode.enableDefaults() 
函数 即 可 。 


一 旦 调用 了 StrictMode.enableDefaults() 函 数 ， 如 果 代 码 有 相关 问 
题 ， 就 能 在 Logcat 看 到 以 下 提醒 : 


在 主线 程 上 发 起 网 络 请 求 ; 

在 主线 程 上 做 了 磁盘 读 写 ; 

Activity 未 及 时 销毁 〈 又 叫 activity 汽 露 ) ; 
SQLite 数 据 库 游 标 未 关闭 ; 

网 络 通信 使 用 了 明文 (未 使 用 SSL/TLS 加 密 )。 


假如 应 用 违反 了 防御 策略 ， 你 想 定制 应 对 行为 ， 可 使 
用 ThreadPolicy.Builder 和 VmPolicy.Builder 类 定制 。 你 可 以 定制 
的 应 对 行为 有 : 控制 是 否 抛 出 异常 、 弹 出 对 话 框 或 是 日 志 记 录 违 有 反 策 略 


警示 信息 。 


25.10 ”挑战 练习 : 观察 视图 LifecycleOwner 的 
LiveData 


PhotoGalleryFragment#é4%7E Fragment .onCreateView(...) PK% 
i] viewLifecycleOwner.lifecycle.observe(...)Pi Bl. XF} 
做 法 不 仅 可 行 还 很 简单 ， 前 提 是 onCreateView(. ..) 函 数 返 回 的 视图 
不 为 null。 


你 不 能 直接 在 Fragment.onCreate(...) 函 数 中 观察 目标 视图 的 生命 周 
期 ， 因 为 目标 视图 只 在 Fragment.onCreateView(... ) 函 数 调用 之 后 

到 Fragment .onDestroyView(...) 调 用 之 前 这 段 时 间 有 效 。 不 过 ， 你 
可 以 转 而 调用 Fragment .getViewLifecycleO0wnerLiveData() (Ck 
回 的 是 一 个 LiveData<Lifecycle0wner>) 来 观察 一 个 fragment 的 视图 


的 生命 周期 。 只 要 Fragment .onCreateView(...) 函 数 返 回 的 视图 不 
Anull, Frdement tiviewl ifecyeleourerat? BAA Za WEEE AY 
LiveData 对 象 。 之 后 ， 它 会 随 Fragment.onDestroyView(...) 的 调 
用 被 设置 为 nu11 值 。 


请 重 构 代 人 码 ， 通 过 Fragment .getViewLifecycle0wnerLiveData() 返 

回 的 LiveData<Lifecycle0wner> 来 观察 fragment 的 

viewLifecycleOwner. 新 添加 的 观察 关系 应 该 和 fragment 实 例 绑 定 。 
只 要 被 观察 对 象 没 有 发 布 nul1 值 ， 就 借助 

viewlitecyeleouner: 1ifecycle 观 察 目 标 fragment 的 视图 生命 周期 。 


25.11 挑战 练习 : 优化 ThumbnailDownloader 


LiveData 是 个 生命 周期 感知 组 件 。 啊 应 其 生命 周期 所 有 者 的 事件 通 
Al 它 能 自动 结束 扮演 观察 者 角色 。 请 更 新 ThumbnailDownloader 
类 ， 让 它 响 应 其 生命 周期 所 有 者 的 ON_DESTROY 事 件 通知 ， 自 动 结束 扮 
演 观 察 者 角色 。 为 此 ，ThumbnailDownloader 需 要 引用 它 所 观察 的 各 
个 生命 周期 所 有 者 。 


ThumbnailDownloader 同 时 观察 fragment 和 fragment 视 图 的 生命 期 的 
事实 ， 让 它 和 Fragment 绑 得 过 紧 。 虽 然 有 很 多 办 法 解决 这 个 问题 ， 但 这 

里 给 你 个 挑战 ， 重 构 ThumbnailDownloader 类 ， 让 它 只 观察 fragment 的 
生命 周期 。 然 后 ， 在 Fragment .onDestroyView( ) 函 数 被 调用 时 ， 让 其 
观察 的 fragment 清 除 下 载 任务 队列 。 


25.12 ”挑战 练习 : 预 加 载 以 及 缓存 


并 非 所 有 应 用 任务 都 能 即时 完成 ， 对 此 ， 大 多 数 用 户 表示 理解 。 不 过 ， 
即便 如 此 ， 开 发 者 也 没 俘 下 追求 完美 的 脚步 。 


为 追求 极速 ， 大 多 数 真 实 应 用 设法 在 两 个 方面 做 代码 增强 : 增加 缓存 层 
和 预 加 载 图 片 。 


缓存 是 指 存储 一 定数 目 Bitmap 对 象 的 地 方 。 这 样 ， 即 使 不 再 使 用 这 些 
对 象 ， 它 们 也 依然 在 那里 。 绥 存 的 存储 空间 有 限 ， 因 此 ， 在 绥 存 空间 用 
完 的 情况 下 ， 需 要 某 种 策略 对 要 保存 的 对 象 做 一 番 取 舍 。 许 多 绥 存 机 制 
使 用 一 种 叫 作 LRU (east recently used， 最 近 最 少 使 用 ) 的 存储 策略 。 


基于 该 种 策略 ， 当 存储 空间 用 尽 时 ， 绥 存 会 清除 最 近 最 少 使 用 的 对 象 。 


Android 支 持 库 中 的 LruCache 类 实现 了 LRU 绥 存 策略 。 作 为 第 一 个 挑战 
练习 ， 请 使 用 LruCache 为 ThumbnailDownloader 增 加 简单 的 缓存 功 

能 。 这 样 ， 每 次 下 载 完 Bitmap 时 ， 将 其 存 入 缓存 。 随 后 ， 准 备 下 载 新 
图 片 时 ， 应 首先 但 看 缓存 ， 确 认 是 合 已 经 有 了 。 


缓存 实现 完成 后 ， 即 可 在 实际 使 用 对 象 前 ， 就 预先 将 它 加 载 到 缓存 中 。 
这 样 ， 在 显示 Bitmap 时 ， 就 不 会 存在 下 载 延 迟 。 


预 加 载 实现 起 来 不 容易 ， 但 对 用 户 来 说 ， 这 会 带 来 截然 不 同 的 使 用 体 
验 。 作 为 第 二 个 稍 有 难度 的 挑战 ， 请 在 显示 GalleryItem 时 ， 为 前 十 个 
和 后 十 个 GalleryItem 预 加 载 Bitmap。 


第 26 章 搜索 


本 章 的 任务 是 学 习 如 何 使 用 SearchView 添 加 搜索 功能 ， 实 现在 
PhotoGallery 应 用 里 搜索 Flickr 网 站 上 的 图 片 。SearchVvView 是 个 操作 视 
图 (action view) 类 ， 你 可 以 把 它 嵌 入 工具 栏 里 。 此 外 ， 我 们 还 会 学 习 
如 何 使 用 SharedPreferences 在 设备 上 保存 数据 。 


搜索 功能 添加 后 ， 点 击 SearchView， 用 户 可 以 输入 查询 关键 字 ， 提 交 
查询 请 求 搜 索 Flickr， 返 回 结果 将 显示 在 RecyclerView 中 ， 如 图 26-1 所 
示 。 用 户 提 交 过 的 查询 关键 字 会 保存 下 来 。 这 样 ， 即 便 应 用 或 设备 重 

启 ， 依 然 可 以 找 回 用 户 的 最 后 一 次 搜索 记录 。 
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图 26-1 搜索 界面 


26.1 搜索 Flickr 网 站 


搜索 Flickr 网 站 需要 调用 flickr .photos.search 方 法 。 以 下 为 搜 
索 “cat" 文 本 的 GET 请 求 示 例 : 


https://api.flickr.com/services/rest/?method=flickr.photos.search 


&api_key=xxx&format=json&nojsoncallback=1&extras=url_s&safe_search=1&text=c 


可 以 看 到 ， 搜 索 方 法 指定 为 flickr.photos.search。 一 个 text 新 参数 
附加 在 请 求 后 面 ， 它 的 内 容 就 是 类 似 “cat" 这 样 的 字符 
串 。safe_search=1 的 作用 是 从 发 回 数据 里 过 滤 掉 不 适宜 的 内 容 。 


有 些 参 数值 对 常量 ， 比 如 format=json， 对 flickr.photos.search 和 
flickr.interestingness .getList 请 求 URL 都 适用 。 你 需要 把 这 些 
共享 参数 值 对 单独 抽出 来 放 到 一 个 拦截 器 Cinterceptor?. E. PX zs HT 
以 按 你 的 预期 行事 一 一 拦截 网 络 请 求 和 啊 应 消息 ， 在 它们 完成 之 前 进行 
某 种 干预 。 

在 api 文 件 夹 里 创建 一 个 名 为 PhotoInterceptor 的 新 Interceptor 类 。 
敌 盖 intercept(chain) 获 取 原 始 网 络 请 求 ， 添 加 需要 的 共享 参数 值 对 后 ， 
产生 新 的 URL， 如 代码 清单 26-1 所 示 。“〔 别 忘 了 添加 第 24 章 创建 的 API 
键 ， 可 以 直接 从 api/FlickrApi.kt 中 将 其 复制 过 来 。) 


代码 清单 26-1 通过 拦截 器 插入 URL 和 常量 (api/Photolnterceptor.kt ) 


private const val API_KEY = "yourApiKeyHere" 


class PhotoInterceptor : Interceptor { 


override fun intercept(chain: Interceptor.Chain): Response { 
val originalRequest: Request = chain.request() 


val newUrl: HttpUrl = originalRequest.url().newBuilder() 
.addQueryParameter("api key", API KEY) 
.addQueryParameter("format", "json") 
.addQueryParameter("nojsoncallback", "1") 
.addQueryParameter("extras", "url s") 
.addQueryParameter("safesearch", "1") 


.build() 


val newRequest: Request - originalRequest.newBuilder() 
.url(newUrl) 
.build() 


return chain.proceed(newRequest) 


导入 Request 和 Response 包 的 时 候 ，Android Studio 会 提供 好 几 个 选择 ， 
记得 选 okhttp3 库 包 。 


上 述 代 码 中 ， 我 们 首先 调用 chain.request() 获 取 到 原始 网 络 请 求 。 
然后 ， 使 用 originalRequest.url() 函 数 从 原始 网 络 请 求 中 取出 原始 
URL， 再 使 用 HttpUr1.Builder 添 加 需要 的 查询 参数 ， 并 创建 出 新 的 
网 络 请 求 。 最 后 ， 调 用 chain.proceed(newRequest) 函 数 产 生 网 络 响 
应 消息 。【〈 这 一 步 不 能 少 ， 否 则 产生 不 了 网 络 请 求 。) 


现在 ， 打 开 FlickrFetchr.kt 文 件 ， 把 拦截 器 添加 到 Retrofit 人 参数 配置 
里 ， 如 代码 清单 26-2 所 示 。 


代码 清单 26-2 添加 拦截 器 (FlickrFetchr.kt) 


class FlickrFetchr ( 
private val flickrApi: FlickrApi 


init { 
val client = OkHttpClient.Builder() 
.addInterceptor(PhotoInterceptor()) 
.build() 


val retrofit: Retrofit - Retrofit.Builder() 
.baseUrl("https://api.flickr.com/") 
.addConverterFactory(GsonConverterFactory.create()) 
.Client(client) 
.build() 


flickrApi = retrofit.create(FlickrApi::class.java) 


上 述 代码 中 ， 我 们 先 创建 一 个 OkHttpC1ient 实 例 ， 再 把 
PhotoInterceptor 添 加 给 它 。 然 后 ， 蔡 换 原 来 的 客户 端 ， 把 新 创建 的 
OkHttpClient 配 置 给 Retrofit。 现 在 ，Retrofit 会 使 用 新 提供 的 客 
户 端 ， 针 对 每 一 个 网 络 请 求 执行 PhotoInterceptor.intercept(...) 
函数 。 


FlickrApi 里 指定 的 flickr.interestingness .getList 现 在 不 需要 
了 。 在 Retrofit API 里 ， 清 理 挥 它 ， 改 用 一 个 searchPhotos() 函 数 来 定 
义 搜 索 请 求 ， 如 代码 清单 26-3 所 示 。 


代码 清单 26-3” 同 FlickrApi 中 添加 搜索 函数 (api/FlickrApi.kt) 


interface FlickrApi { 


@GET("services/rest?method=flickr.interestingness.getList") 
fun fetchPhotos(): Call<FlickrResponse> 


@GET 
fun fetchUrlBytes(QUrl url: String): Call«ResponseBody» 


QGET("services/rest?method-flickr.photos.search") 
fun searchPhotos(@Query("text") query: String): Call<FlickrResponse> 


@Qnuery 注 解 允 许 你 动态 拼接 查询 参数 后 再 拼接 到 URL 串 里 。 这 里 ， 你 
拼接 的 查询 参数 叫 text。text 的 配对 值 由 searchPhotos(String) 传 
入 。 例 如 ， 调 用 searchPhotos("robot") 的 结果 就 是 产生 text=robot 
并 添加 到 URL 里 。 


如 代码 清单 26-4 所 示 ， 在 FlickrFetchr 中 ， 添 加 一 个 搜索 函数 封装 新 
添加 的 FlickrApi.searchPhotos(String)。 同 时 ， 把 异步 执行 Call 
对 象 返回 结果 封装 到 LiveData 的 这 段 代 码 放 入 辅助 工具 函数 里 。 


代码 清单 26-4 向 FlickrFetchr 中 添加 搜索 函数 
(FlickrFetchr.kt) 


class FlickrFetchr { 


private val flickrApi: FlickrApi 
init { 
} 


fun fetchPhotos(): LiveData<List<GalleryItem>> { 
return fetchPhotoMetadata(flickrApi.fetchPhotos()) 
} 


fun searchPhotos(query: String): LiveData<List<GalleryItem>> { 
return fetchPhotoMetadata(flickrApi.searchPhotos (query) ) 
} 


Fun_fetehphetes()，tLivepata<tistk6alleryH f 


private fun fetchPhotoMetadata(flickrRequest: Call<FlickrResponse>) 
: LiveData<List<GalleryItem>> { 
val responseLiveData: MutableLiveData<List<GalleryItem>> = MutableLiv 


E ET t: CalleFlicken - £lickrApi-fetchPhotesC 


flickrRequest.enqueue(object : Callback<FlickrResponse> { 


J) 


return responseLiveData 


} 
Ta 


最 后 ， 如 代码 清单 26-5 所 示 ， 更 新 PhotoGalleryViewModel， 发 起 
Flickr 搜 索 。 现 在 ， 先 便 编 码 搜索 关键 字 为 “planets”"。 尺 管 还 没有 为 用 户 
提供 输入 查询 的 UI， 但 可 以 使 用 硬 编 码 搜索 关键 字 来 测试 搜索 代码 。 


代码 清单 26-5 ”发 起 搜索 CPhotoGalleryViewModel.kt) 


class PhotoGalleryViewModel : ViewModel() { 
val galleryItemLiveData: LiveData<List<GalleryItem>> 


init { 


galleryItemLiveData = FlickrFetchr(). 


—searchPhotos("planets") 


} 
} 


虽然 搜索 请 求 URL 和 之 前 用 来 请 求 任意 图 片 的 URL 不 一 样 ， 但 搜索 返回 
的 JSON 数 据 格 式 还 是 一 样 的 。 这 是 好 事 ， 因 为 Gson 数 据 解 析 配 置 和 数 
拓 模 型 映射 代码 不 用 男 写 了 ， 和 直接 用 就 可 以 。 


运行 PhotoGallery 应 用 并 查看 返回 结果 。 如 果 没 有 什么 问题 ， 应 该 可 以 
看 到 一 两 张 地 球 图 片 。〔 如 果 返 回 图 片 和 地 球 完 全 不 搭 边 ， 也 不 要 简单 
地 认为 搜索 有 问题 。 建 议 试 试 别 的 搜索 关键 字 ， 比 
如 “bicycle” 或 “ama”， 直 到 看 到 预期 的 搜索 结果 。) 


26.2 ”使 用 SearchView 


既然 FlickrFetchr 已 支持 搜索 ， 现 在 就 来 用 SearchView 创 建 搜 索 界 
面 ， 让 用 户 输入 查询 关键 字 并 触发 搜索 。 


re ene 可 以 让 整个 搜索 界面 完全 内 置 在 应 用 的 工 
具 栏 中 。 


接 下 来 ， 为 PhotoGalleryFragment 创 建 一 个 名 为 
res/menu/fragment photo. gallery.xmlIf] 35 XML X F. fn] Ego 
文件 指定 工具 栏 上 要 显示 什么 ， 如 代码 清单 26-6 所 示 。 


代码 清单 26-6 ”添加 菜单 XML 文件 


(res/menu/fragment_photo_gallery.xml ) 


«menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 


<item android:id-"(Mid/menu item search" 
android: title="@string/search" 
app: actionViewClass="androidx.appcompat.widget.SearchView" 
app: showAsAction="ifRoom" /> 


android: id="@+id/menu_item_clear" 
android: title="@string/clear_search" 
app: showAsAction="never" /> 


</menu> 


新 XML 文件 会 出 现 一 些 错误 ， 因 为 目前 还 没有 为 android:tit1le 属 性 
定义 字符 串 。 暂 时 忽略 这 些 ， 稍 后 会 处 理 。 


通过 为 app:actionViewClass 属 性 指定 
androidx.appcompat.widget.SearchView 值 ， 代 码 清单 26-6 中 的 第 
一 个 定义 项 告诉 工具 栏 要 显示 SearchView。 CER, showAsActionjl 
actionViewClass 属 性 都 需要 使 用 app 命 名 空间 。 如 果 不 清楚 为 什么 要 
用 ， 请 复习 一 下 第 14 章 中 的 相关 内 容 。) 

代码 清单 26-6 中 的 第 二 个 定义 项 会 添加 一 个 Clear Search 选 项 。 由 于 
app:showAsAction 属 性 值 设置 为 了 never， 因 此 这 个 选项 就 只 能 出 现 
在 溢出 菜单 中 。 后 面 ， 我 们 会 配置 它 ， 实 现 点 击 该 选项 就 删除 已 保存 的 
搜索 字符 串 。 现 在 先 忽略 它 。 


现在 来 解决 染 单 XML 中 的 未 定义 字符 串 错 误 。 打 开 res/values/strings.xml 
文件 ， 添 加 缺失 的 字符 串 ， 如 代码 清单 26-7 所 示 。 


代码 清单 26-7 添加 搜索 字符 串 (res/values/strings.xml ) 


<resources> 


«string name-"search"»Search«/string» 
«string name="clear_search">Clear Search</string> 


</resources> 


ia» 1]JFPhotoGalleryFragment.ktX fF, fEonCreate(...) KZH 
用 setHasOptionsMenu(true) 函 数 让 fragment 接 收 菜单 回调 函数 。 然 
后 ， 如 代码 清单 26-8 所 示 ， 履 盖 onCreateOptionsMenu(...) 函 数 并 实 
例 化 菜单 XML 文件 。 这 样 ， 工 具 栏 就 能 显示 定义 在 菜单 XML 中 的 选项 
me 


代码 清单 26-8 履 盖 onCreate0ptionsMenu(.. .) 函 数 
(PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


retainInstance - true 
setHasOptionsMenu(true) 


} 


override fun onDestroy() { 


} 


override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
super.onCreateOptionsMenu(menu, inflater) 
inflater.inflate(R.menu.fragment photo gallery, menu) 


运行 PhotoGallery 看 看 SearchView 的 界面 是 什么 样 的 。 点 击 Search 按 
钮 ， 会 出 现 一 个 供用 户 输入 的 文本 框 ， 如 图 26-2 所 示 。 
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图 26-2 ”搜索 界面 


SearchView 展 开 后 ， 一 个 x 按钮 会 出 现在 右边 。 点 击 它 会 删除 用 户 输 入 
文字 。 再 次 点 击 它 ，SearchView 就 会 回 到 只 有 一 个 搜索 按钮 的 界面 。 


现在 尝试 提交 搜索 不 会 有 任何 结果 。 不 要 急 ，SearchView 稍 后 就 会 有 
响应 。 


啊 应 用 户 搜索 


用 户 提 交 碍 询 后 ， 应 用 立即 开始 搜索 Flickr 网 站 ， 然 后 刷新 显示 搜索 结 
果 。 首 先 ， 更 新 PhotoGalleryViewMode1， 保 存 用 户 的 最 近 搜 索 记 
录 ， 在 查询 更 改 时 刷新 搜索 结果 ， 如 代码 清单 26-9 所 示 。 


代码 清单 26-9 保存 最 近 搜 索 记 录 〈PhotoGalleryViewModel.kt) 


class PhotoGalleryViewModel : ViewModel() { 


val galleryItemLiveData: LiveData<List<GalleryItem>> 


private val flickrFetchr = FlickrFetchr() 
private val mutableSearchTerm = MutableLiveData<String>() 


init { 
mutableSearchTerm.value = "planets" 


galleryItemLiveData = 


Transformations.switchMap(mutableSearchTerm) { searchTerm - 
flickrFetchr.searchPhotos(searchTerm) 


} 
} 
fun fetchPhotos(query: String = "") { 
mutableSearchTerm.value = query 
} 


每 次 搜索 关键 字 更 改 时 ， 图 片 列表 项 要 反应 最 新 搜索 结果 。 由 于 搜索 关 
键 字 和 图 片 列表 项 都 封装 在 LiveData 里 ， 因 此 你 可 以 使 


用 Transformations.switchMap(trigger: LiveData<X>， 


transformFunction: Function<X，LiveData<Y>>) 来 啊 应 用 户 搜 索 
(LiveData 数 据 转换 详 见 第 12 章 ) 。 


FlickrFetchr 实 例 保 存在 一 个 属性 里 ， 这 样 ， 我 们 可 以 保证 

在 ViewModel 实 例 的 生命 周期 里 ， 只 会 创建 一 个 FlickrFetchr 实 例 。 
复 用 同一 个 FlickrFetchr 实 例 的 好 处 是 ， 不 用 做 无 用 功 ， 执 行 一 次 搜 
索 就 能 新 建 一 个 Retrofit 和 FlickrApi。 应 用 运行 速度 因此 会 快 很 
多 。 


接 下 来 ， 更 新 PhotoGalleryFragment， 只 要 用 户 通 过 SearchView 提 
交 新 搜索 ， 就 更 新 PhotoGalleryViewModel 保 存 的 搜索 值 。 查 阅 开发 
文档 可 知 ，SearchView.0OnQueryTextListener 接 口 己 提 供 了 接收 回 
调 的 方式 ， 可 以 响应 查询 指令 。 


更 新 onCreateOptionsMenu(...) 函 数 ， 添 加 一 
个 SearchView.OnQueryTextListener 监 听 函 数 ， 如 代码 清单 26-10 所 
ZN o 


代码 清单 26-10 ”日 志 记 录 SearchView.0nQueryTextListener 事 
件 CPhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
super.onCreateOptionsMenu(menu, inflater) 
inflater.inflate(R.menu.fragment photo gallery, menu) 


val searchItem: MenuItem = menu.findItem(R.id.menu item search) 
val searchView - searchItem.actionView as SearchView 


searchView.apply { 


setOnQueryTextListener(object : SearchView.OnQueryTextListener 
override fun onQueryTextSubmit(queryText: String): Boolean 
Log.d(TAG, "QueryTextSubmit: $queryText") 
photoGalleryViewModel.fetchPhotos(queryText) 
return true 


j 


override fun onQueryTextChange(queryText: String): Boolean 
Log.d(TAG, "QueryTextChange: $queryText") 
return false 


导入 SearchView 时 ， 记 得 选择 
androidx.appcompat.widget.SearchView. 


在 onCreate0ptionsMenu(. . .) 函 数 中 ， 我 们 首先 从 菜单 中 取出 
MenuItem 并 把 它 保存 在 searchItem 变 量 中 。 然 后 ， 使 
用 getActionView() 函 数 从 这 个 变量 中 取出 SearchView 对 象 。 


取 到 SearchView 对 象 ， 就 可 以 使 用 setonQueryTextListener(...) 
函数 设置 SearchView.0nQueryTextListener 了 。 另 外 ， 你 还 必须 履 
盖 SearchVview.0OnQueryTextListener 里 的 
onQueryTextSubmit (String) MlonQueryTextChange (String) Ñ 
数 。 


只 要 searchView 文 本 框 里 的 文字 有 变 

化 ，onQueryTextChange(String) 回 调 函 数 就 会 执行 。 在 PhotoGallery 
应 用 中 ， 除 了 记 日 志和 返回 false 值 ， 这 个 回调 函数 不 会 做 其 他 任何 
事 。 返 回 false 值 是 告诉 系统 ， 回 调 才 盖 函数 啊 应 了 搜索 指令 变化 但 没 
有 做 出 处 理 。 这 实际 是 暗示 系统 去 执行 SearchView 的 默认 动作 (这 里 
指 显示 相关 搜索 建议 ， 如 果 有 的 话 ) 。 


当 用 户 提交 搜索 查询 时 ，onQueryTextSubmit(Sstring) 回 调 函 数 就 会 
执行 。 用 户 提 交 的 搜索 字符 串 会 传 给 它 。 搜 索 请 求 受 理 后 ， 该 函数 会 返 
回 true。 这 个 函数 也 会 调 

用 PhotoGalleryViewModel.fetchPhotos(queryText) 去 下 载 图 片 。 


运行 应 用 并 发 起 搜索 查询 。 如 图 26-3 所 示 ， 响 应 你 的 搜索 请 求 ， 图 片 重 
新 加 载 了 。 另 外 ， 在 日 志 中 可 以 看 
到 SearchView.OnQueryTextListener 回 调 函 数 已 成 功 执 行 。 


aia Se) oh ghj ie 
fe z OX ey ob on mG 


giza © .Q 


图 26-3 ”搜索 界面 


注意 : 如 果 在 模拟 磺 上 使 用 物理 键盘 《比如 笔记 本 计算 机 的 键盘 ) 提交 
查询 ， 那 么 搜索 会 连续 执行 两 次 。 从 用 户 角 度 看 ， 就 是 先 看 到 下 载 的 搜 
索 结果 ， 然 后 这 些 图 片 又 全 部 重新 加 载 一 次 。 这 征 SearchView 的 一 个 
bug， 只 会 出 现在 模拟 右上， 可 以 不 用 理会 。 


26.3 ”使 用 sharedpreferences 实 现 轻 量 级 数据 存储 


在 PhotoGallery 应 用 中 ， 一 次 只 有 一 个 激活 的 得 询 。 应 用 应 该 保存 这 个 
查询 ， 即 使 应 用 或 设备 重 局 也 不 会 丢失 。 


要 实现 这 个 目标 ， 可 以 把 查询 字符 串 写 入 shared preferences。 只 要 用 户 
提交 查询 ， 就 把 它 写 入 shared preferences， 禾 盖 掉 之 前 记录 的 字符 串 。 
实际 搜索 Flickr 时 ， 就 从 shared preferences 中 取出 查询 字符 串 ， 把 它 作 
为 text 参 数值 。 


shared preferences 本 质 上 就 是 文件 系统 中 的 文件 ， 可 使 

用 SharedPreferences 类 读 写 它 。SharedPreferences 实 例 用 起 来 更 
像 一 个 键 值 对 仓库 GET Bundle) ， 但 它 可 以 通过 持久 化 存储 保存 
数据 。 键 值 对 中 的 键 为 字符 串 ， 而 值 是 原子 数据 类 型 。 进 一 步 查 看 
shared preferences 文 件 可 知 ， 它 们 实际 上 是 一 种 简单 的 XML 文件 ， 

但 SharedPreferences 类 已 屏蔽 了 读 写 文件 的 实现 细节 。 


shared preferences 文 件 保存 在 应 用 沙 盒 中 ， 因 此 ， 不 应 用 它 保 存 类 似 密 
码 这 样 的 敏感 信息 。 


如 代码 清单 26-11 所 示 ， 添 加 一 个 名 为 QueryPreferences 的 便利 类 ， 用 
于 读 取 和 写 入 查询 字符 串 。 


代码 清单 26-11 管理 保存 的 查询 字符 串 (QueryPreferences.kt) 


private const val PREF SEARCH QUERY = "searchQuery" 


object QueryPreferences { 


fun getStoredQuery(context: Context): String { 
val prefs = PreferenceManager.getDefaultSharedPreferences (context) 
return prefs.getString(PREF_SEARCH_QUERY, "")!! 


} 


fun setStoredQuery(context: Context, query: String) { 
PreferenceManager.getDefaultSharedPreferences (context) 
.edit() 
.putString(PREF SEARCH QUERY, query) 
-apply() 


应 用 只 需要 一 个 能 在 所 有 其 他 组 件 中 共享 的 QueryPreferences 实 例 。 
因此 ， 我 们 使 用 Object 关键 字 《〈 而 不 是 class) 声 

明 QueryPreferences 是 一 个 单 例 。 这 样 ， 除 了 控制 只 能 创建 一 个 实例 
外 ， 你 还 能 以 ClassName.functionName(...) 的 语法 形式 访问 这 个 单 
例 对 象 里 的 函数 。 


PREF_SEARCH_QUERY 是 查询 字符 串 的 存储 key， 读 取 和 写 入 都 要 用 到 
ee 


PreferenceManager.getDefaultSharedPreferences (Context) 
数 会 返回 具有 私有 权限 和 默认 名 称 的 实例 《〈 仅 在 当前 应 用 内 可 用 ) 。 要 
获得 SharedPreferences 定 制 实例 ， 可 使 

用 Context .getSharedpPreferences(String，Int) 函 数 。 然 而 ， 在 
实际 开发 中 ， 我 们 并 不 关心 SharedPreferences 实 例 具 体 什 么 样 ， 只 

要 它 能 共享 于 整个 应 用 就 可 以 了 。 


getStoredQuery (Context) RK Zi [lshared preferences 中 保存 的 查询 字 
符 串 值 。 不 过 ， 它 首先 要 找到 指定 context 中 的 默认 
SharedPreferences. (因为 QueryPreferences 类 没有 自己 的 
Context， 所 以 该 函数 的 调用 者 必须 传 入 一 个 。) 


取出 查询 字符 串 值 非常 简单 ， 调 

用 SharedPreferences .getString(...) 就 可 以 了 。 如 果 是 其 他 类 型 
数据 ， 就 调用 对 应 的 取 值 函 数 ， 比 如 

getInt(...). SharedPreferences.getString (String, 
String) ZEB TER E T ARWR EHE, AERA 

到 PREF _SEARCH_QUERY 对 应 的 值 。 


SharedPreferences.getString(...) 返 回 类 型 是 个 可 空 String 类 
型 ， 因 为 编译 器 不 能 保证 PREF_SEARCH_QUERY 关 联 值 肯定 非 空 。 但 你 


绝对 不 会 让 PREF_SEARCH_QUERY 关 联 空 值 。 因 此 ， 你 提供 了 一 个 

空 String 默 认 值 ， 这 样 ， 即 使 setSstoredQuery(context : Context, 
query: String) 没 调用 也 没关系 。 这 里 ， 无 须 try/catch 语 句 包 庄 ， 
使 用 非 空 断 言 操 作 符 就 很 安全 了 。 


setStoredQuery (Context) K Zt [n] 4E context I] EA A shared 
preferences; A AWH. fEQueryPreferences'P, ji 

用 SharedPreferences .edit() 函 数 ， 可 获取 一 

个 sharedPreferences .Editor 实 例 。 它 就 是 在 SharedPreferences 
中 保存 查询 信息 要 用 到 的 类 。 与 FragmentTransaction 的 使 用 类 似 ， 
利用 SharedPreferences.Editor， 可 将 一 组 数据 操作 放 入 一 个 事务 
中 。 如 果 你 有 一 批 数 据 要 更 新 ， 那 么 在 一 个 事务 中 批量 写 入 就 可 以 了 。 


完成 所 有 数据 的 变更 准备 后 ， 调 用 SharedPreferences .Editor 的 
apply() 异 步 函 数 写 入 数据 。 这 样 ， 该 SharedPreferences 文 件 的 其 他 
用 户 就 能 看 到 写 入 的 数据 了 。apply() 函 数 首先 在 内 存 中 执行 数据 变 
更 ， 然 后 在 后 台 线 程 上 真正 把 数据 写 入 文件 。 


QueryPreferences 是 PhotoGallery 应 用 的 数据 存储 引擎 。 


既然 已 经 搞定 了 查询 信息 的 读 取 和 写 入 ， 那 就 更 新 
PhotoGalleryViewModel 按 需 读 写 Shared Preferences。 在 首次 创建 
ViewModel 时 读 出 搜索 记录 ， 用 它 初 始 化 mutableSearchTerm。 一 旦 
mutableSearchTerm 有 变化， 束 保 存 搜索 记录 ， 如 代码 清单 26-12 所 
示 。 


代码 清单 26-12 存储 用 户 提 交 的 查询 信息 
(PhotoGallery ViewModel.kt) 


- 6 PhotoGalleryViewModel— ViewModelC) f 


class PhotoGalleryViewModel(private val app: Application) : AndroidViewMode 
init ( 
mutableSearchTerm.value - 


—QueryPreferences.getStoredQuery(app) 


} 


fun fetchPhotos(query: String = "") { 
QueryPreferences.setStoredQuery(app, query) 
mutableSearchTerm.value = query 


PhotoGalleryViewMode1 需 要 一 个 上 下 文 来 使 用 QueryPreferences 
函数 。 因 此 ， 需 要 把 PhotoGalleryViewMode1 的 父 类 从 ViewMode1l 改 
为 AndroidViewModel， 让 它 能 访问 应 用 上 下 文 。 既 

然 PhotoGalleryViewMode1l 没 应 用 上 下 文 “ 活 得 久 ”， 那 么 它 引 用 应 用 
上 下 文 就 是 安全 的 。 


接 下 来 ， 在 用 户 从 溢出 菜单 选择 Clear Search 选 项 时 清除 存储 的 查询 信息 
(设置 为 "") ， 如 代码 清单 26-13 所 示 。 


代码 清单 26-13 ”清除 查询 信息 (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 
override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 


} 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
return when (item.itemId) { 


R.id.menu item clear -> ( 
photoGalleryViewModel.fetchPhotos("") 
true 


} 


else -> super.onOptionsItemSelected(item) 


最 后 ， 更 新 PhotoGalleryViewMode1， 在 清除 查询 信息 时 ， 获 取 一 些 
随机 图 片 ， 如 代码 清单 26-14 所 示 。 


代码 清单 26-14 ”过 空 查询 就 随机 抓 取 一 些 图 片 
(PhotoGalleryViewModel.kt) 


class PhotoGalleryViewModel(private val app: Application) : AndroidViewMode 


init { 


mutableSearchTerm.value = QueryPreferences.getStoredQuery (app) 


galleryItemLiveData = 
Transformations.switchMap(mutableSearchTerm) { searchTerm - 
if (searchTerm.isBlank()) ( 
flickrFetchr.fetchPhotos() 
) else { 
flickrFetchr.searchPhotos(searchTerm) 


} 


搜索 功能 现在 应 该 能 用 了 。 运 行 PhotoGallery 应 用 ， 洋 试 搜 

索 “unicycle” 并 查看 返回 结果 。 然 后 ， 按 回 退 键 完 全 退出 应 用 ， 或 者 更 

2 重启 设备 。 不 出 所 料 ， 再 次 重启 应 用 时 ， 你 应 该 能 看 到 同样 的 
索 结 果 。 


26.4 优化 应 用 

搜索 功能 实现 后 ， 精 益 求 精 ， 可 以 考虑 做 点 应 用 优化 了 。 如 果 用 户 点 击 
HERRAR Searchview!y, 搜索 文本 框 能 显示 已 保存 的 查询 字符 串 
该 多 好 。 


首先 ， 在 PhotoGalleryViewModel 里 ， 添 加 一 个 计算 属性 显示 搜索 关 
键 字 ， 如 代码 清单 26-15 所 示 。 


代码 清单 26-15 ”展示 搜索 关键 字 CPhotoGalleryViewModel.kt) 


class PhotoGalleryViewModel(private val app: Application) : AndroidViewMode 


private val mutableSearchTerm = MutableLiveData<String>() 


val searchTerm: String 
get() = mutableSearchTerm.value ?: "" 


init { 


用 户 点 击 搜索 按钮 时 ，SearchVview 的 
View.OnClickListener.onClick() 函 数 会 被 调用 。 利 用 这 个 回调 函 
数 设 置 搜索 文本 框 的 值 ， 如 代码 清单 26-16 所 示 。 


代码 清单 26-16 Filip ARC CPhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 
override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
searchView.apply { 


setOnQueryTextListener(object : SearchView.OnQueryTextListener 


}) 


setOnSearchClickListener { 
searchView.setQuery(photoGalleryViewModel.searchTerm, false 


} 
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26.5 ”用 Android KTX2 44 SharedPreferences 


Android KTX 是 Jetpack 里 的 一 套 Kotlin 扩 展 库 。 有 了 它 ， 在 使 用 Java 版 
Android API 编 写 代 人 码 时 ， 就 可 以 直接 使 用 Kotlin 的 一 些 语言 特性 了 。 使 
用 Android KTX 只 会 让 你 写 的 代码 更 具 Kotlin 风 格 ， 不 会 更 改 现 有 Java 
API 的 功能 。 


本 书 撰写 时 ，Android KTX 只 为 部 分 Android Java API 提 供 了 对 应 的 扩展 
E. BERERE, AAA Android KTX 文 档 。 不 过 ，Android KTX 核 心 


库 里 有 编辑 SharedPreferences 的 扩展 。 

现在 ， 我 们 就 来 更 新 QueryPreferences 类 把 Android KTX 用 起 来 。 首 
先 ， 在 app/build.gradle 文 件 里 添加 Android KTX 库 依赖 ， 如 代码 清单 26- 
17 所 示 。 


代码 清单 26-17 添加 core-ktx 依 赖 项 (app/build.gradle) 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 


implementation 'androidx.core:core-ktx:1.0.0' 


fe BOR. He rQueryPreferences.setStoredQuery(...) PA ZI E EAA 
Android KTX， 如 代码 清单 26-18 所 示 。 


代码 清单 26-18 ”使 用 Android KTX (QueryPreferences.kt) 


object QueryPreferences { 


fun setStoredQuery(context: Context, query: String) { 
PreferenceManager.getDefaultSharedPreferences (context) 
edit 


putString(PREF SEARCH QUERY, query) 


SharedPreferences.edit(commit: Boolean = false, action: 
Editor.() -> Unit) 是 core-ktx 里 的 一 个 扩展 函数 。 如 果 代 码 有 


错 ， 请 检查 是 否 导 入 了 androidx.core.content .edit。 


把 要 做 的 修改 放 在 lambda 参 数 里 ， 我 们 把 它 传 


入 SharedPreferences.Editor。 这 里 是 
指 android.content.SharedPreferences.Editor.putSstring(...) 


的 返回 值 。 


因为 edit 扩 展会 自动 为 你 调用 apply() 函 数 ， 所 以 这 里 删除 了 
SharedPreferences.Editor.apply() 显 式 调用 。 可 以 通过 将 true 作 
为 参数 传 给 edit 扩 展 函 数 来 覆盖 此 默认 行为 。 这 样 做 会 导 臻 edit 调 
用 SharedPreferences .Editor.commit() 而 不 

是 SharedPreferences .Editor.apply()。 


运行 应 用 ， 确 保 PhotoGallery 的 功能 不 受 影响 。 现 在 ，shared preferences 
代码 的 Kotlin 风 格 更 明显 了 ， 相 信 Kotlin 迷 会 喜欢 的 。 


26.6 ”挑战 练习 : 优化 PhotoGallery 应 用 


你 也 许 注意 到 了 ， 提 交 搜索 时 ，RecyclerView 要 等 一 会 儿 才 能 刷新 显 
示 搜 索 结 果 。 请 接受 挑战 ， 让 搜索 响应 更 迅速 一 些 。 用 户 一 提交 搜索 ， 
SLRS IE 收 起 searchView 视 图 〈 回 到 只 显示 搜索 按钮 的 初始 状 
N) o 


ARKA. HAIER, M a RecyclerView, an~ ^ 48A 
结果 加 载 状 态 界面 (使 用 状态 指示 器 ) 。 下 载 到 JSON 数 据 之 后 ， 束 删 
除 状态 指示 器 。 也 就 是 说 ， 一 旦 开始 下 载 图 片 ， 束 不 应 显示 加 载 状态 
qs 
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PhotoGallery 应 用 现在 不 仅 可 以 下 载 Flickr 网 站 图 片 ， 还 能 让 用 户 输入 关 
键 字 搜索 图 片 。 本 章 ， 我 们 为 PhotoGallery 应 用 再 添 一 项 功能 ， 人 允许 其 
在 后 台 轮 询 访问 Flickr， 看 看 有 没有 新 图 片 发 布 。 


轮 询 工 作 会 一 直 在 后 台 悄 悄 进 行 ， 用 户 打 不 打开 应 用 都 一 样 。 一 旦 有 了 
新 发 现 ， 应 用 会 发 出 通知 告诉 用 户 。 


为 实现 这 种 周期 性 查看 Flickr 网 站 新 图 片 的 任务 ， 需 要 用 到 Jetpack 
WorkManager 架 构 组 件 里 的 一 些 工 具 。 你 会 创建 一 个 Norker 类 负责 实际 
工作 ， 然 后 以 一 定时 间 间 隔 让 它 执行 。 一 旦 发 现 新 图 片 ， 就 让 
NotificationManager 给 用 户 发 送 一 个 通知 。 


27.1 创建 Worker 类 


你 需要 的 后 台 任务 逻辑 会 被 放 在 一 个 Norker 类 里 。 创 建 了 Norker 类 之 
后 ， 你 还 会 创建 一 个 NorkRequest 告 诉 系统 何 时 执行 任务 。 


首先 ， 开 始 准备 工作 ， 在 app/build.gradle 文 件 里 添加 需要 的 依赖 ， 如 代 
码 清 单 27-1 所 示 。 


代码 清单 27-1 添加 NorkManager 依 赖 Capp/build.gradle?) 


dependencies { 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 


implementation "android.arch.work:work-runtime:1.0.1" 


添加 完成 后 ， 记 得 同步 项 目下 载 依 赖 库 。 


搞定 了 依赖 库 之 后 ， 接 下 来 就 是 创建 Worker 类 。 创 建 一 个 名 
为 PollWorker 的 新 类 ， 让 它 继 承 Worker 基 类 。PollWorker 类 需要 两 
个 参数 ， 一 个 Context 和 一 个 WorkerParameters 对 象 。 它 们 会 被 传 给 


超 类 的 构造 函数 。 现 在 ， 先 覆盖 doNork() 函 数 向 控制 台 打 印 一 些 日 
志 ， 如 代码 清单 27-2 所 示 。 


代码 清单 27-2 ”创建 Norker 类 CPollWorker.kt) 


private const val TAG = "PollWorker" 


class PollWorker(val context: Context, workerParams: WorkerParameters) 
: Worker(context, workerParams) ( 


override fun doWork(): Result { 
Log.i(TAG, "Work request triggered") 
return Result.success() 


dowork() 会 在 后 台 线 程 上 调用 ， 你 不 能 安排 它 做 任何 耗 时 任务 。 该 函 
数 的 返回 值 表 示 任 务 执行 结果 状态 。 这 里 ， 先 返回 成 功 状态 ， 因 为 它 当 
前 的 任务 只 是 打印 一 条 日 志 。 


如 果 任 务 完 不 成 ， 可 以 让 doworKk() 返 回 失败 状态 。 如 有 果 发 生 这 样 的 
事 ， 它 的 任务 就 不 会 再 运行 了 。 如 果 只 是 遇 到 一 个 临时 间 题 ， 你 希 
望 doWork() 里 的 任务 之 后 能 再 次 运行 ， 可 以 安排 它 返 回 一 个 重 试 结 
A. 


PollWorker 只 知道 如 何 执行 后 人 台 任 务 。 至 于 何 时 执行 ， 你 还 需要 另 一 
个 组 件 来 调度 工作 。 


27.2 ”调度 工作 


为 调度 Po1lNWorker 执 行 任 务 ， 你 需要 一 个 NorkRequest 关 协 

助 。WorkRequest 类 本 里 是 个 抽象 类 ， 根 据 待 执行 任务 的 类 型 ， 你 需要 
使 用 它 的 某 个 实现 子 类 。 如 果 要 执行 一 次 性 任务 ， 就 使 

用 OneTimeWorkRequest 类 ; 如 果 要 定期 执行 任务 ， 束 使 

用 PeriodicWorkRequest 类 。 


简单 起 见 ， 这 里 先 用 OneTimeWorkRequest， 以 方便 验证 PollWorker 
是 否 能 正常 工作 ， 并 学 习 如 何 创建 和 控制 NorkRequest。 之 后 ， 你 将 升 
级 应 用 以 使 用 PeriodicWorkRequest。 


打开 PhotoGalleryFragment.kt， 创 建 一 个 WorkRequest， 安 排 其 执行 ， 
如 代码 清单 27-3 所 示 。 


代码 清单 27-3 ”调度 一 个 WorkRequest (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 


lifecycle.addObserver(thumbnailDownloader.fragmentLifecycleObserver 


val workRequest = OneTimeWorkRequest 
.Builder(PollWorker::class.java) 
.build() 

WorkManager.getInstance() 
.enqueue(workRequest) 


OneTimeWorkRequest 使 用 构造 器 构造 实例 。 这 里 提供 给 构造 器 的 是 要 
执行 的 Worker 类 。WorkRequest 准 备 好 之 后 ， 你 需要 使 

用 WorkManager 类 安排 执行 。 调 用 getInstance( ) 函 数 可 以 获得 一 
个 WorkManager 实 例 ， 然 后 传 入 准备 好 的 WorkRequest， 调 

用 enqueue(...) 函 数 把 任务 放 入 队列 。 这 样 ， 基 于 WorkRequest 类 型 
及 其 受 限 条 件 ， 任 务 就 按 计 划 执 行 了 。 


运行 应 用 ， 在 Logcat 窗 口 输入 PollWorker 搜 寻 日 志 。 很 快 ， 你 应 该 会 看 
到 预期 的 日 志和 输出， 如 图 27-1 所 示 。 


Logeat tL 


i Emulator Book, Sereensho |o Com. dignerdranch, android hi) Verbose fe) | V" PollWorker C) Regex No Fiters 


& 2019-01-15 12:08:25,382 16353-16383/ com, bi gnerdranch, android. photogallery I/Pollworker: Work request triggered 
a 2019-01-15 12:08:25,385 16353-16369/com, bignerdranch, android. photogallery L/M-Workerrapper: Worker result SUCCESS for Work | 
id=a29688ea-b1c2-464e-a6c4-69e50d795ae8, tags={ com,bignerdranch, android, photogallery,Pollworker } ] 
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图 27-1 任务 执行 日 志 


很 多 时 候 ， 你 需要 在 后 合 执行 的 任务 会 用 到 网 络 ， 比 如 轮 询 获取 用 户 想 
看 的 新 信息 ， 或 者 把 本 地 数据 库 的 更 新 发 布 到 远程 服务 器 保存 。 这 些 任 
务 虽然 离 不 开 网 络 ， 但 也 应 精打细算 不 瞎 浪 费 宝贵 的 数据 流量 。 最 好 是 
在 设备 连 上 无 线 网 络 再 执行 你 的 任务 。 


你 可 以 使 用 Constraints 类 给 你 的 工作 任务 添加 受 限 信息 ， 比 如 ， 可 以 
指定 在 满足 东 种 条 件 时 才能 执行 预定 工作 任务 。 需 要 满足 东 种 网 络 条 件 
古 一 种 情况 。 妨 外 ， 你 也 可 以 设置 像 电 池 电 量 充足 或 设备 处 于 充电 状态 


等 条 件 。 


如 代码 清单 27-4 所 示 ， 在 PhotoGalleryFragment 里 编辑 
OneTimeWorkRequest， 给 工作 任务 添加 限制 条 件 。 


代码 清单 27-4 ”添加 任务 受 限 条 件 (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 
lifecycle.addObserver(thumbnailDownloader.fragmentLifecycleObserver 


val constraints = Constraints.Builder() 
. setRequiredNetworkType(NetworkType.UNMETERED) 


.build() 
val workRequest = OneTimeWorkRequest 
.Builder(PollWorker::class.java) 
.setConstraints(constraints) 
.build() 
WorkManager.getInstance() 
.enqueue(workRequest) 


与 WorkRequest 类 似 ，Constraints 对 象 也 使 用 一 个 构造 器 来 配置 新 实 
例 。 这 里 ， 为 了 让 WorkRequest 执 行 ， 你 要 求 设 备 必须 连 上 不 计 流 量 网 
络 。 


为 测试 这 项 功能 ， 你 需要 在 模拟 器 设备 上 模拟 不 同 的 网 络 类 型 。 默 认 情 
况 下 ， 模 拟 器 连接 的 是 一 个 模拟 Wi-Fi 网 络 。 既 然 Wi-Fi 就 是 不 计 流 量 网 
络 ， 那 么 如 果 现 在 运行 应 用 ， 你 应 该 能 看 到 来 自 PollWorker 的 日 志 输 

Bis 


为 验证 NorkRequest 不 会 在 按 流 量 计 费 网 络 上 运行 ， 你 需要 先 修改 模拟 
器 的 网 络 设置 。 退 出 PhotoGallery 应 用 ， 在 消息 通知 区 域 下 滑 展 开设 备 
的 快捷 设置 界面 。 然 后 ， 在 此 区 域 再 次 下 滑 一 次 ， 展 开 一 个 完整 版 本 的 
快捷 设置 界面 ， 如 图 27-2 所 示 。 无 论 哪个 系统 版 本 都 可 以 ， 但 在 某 些 旧 
版 Android 系 统 上 ， 访 问 网 络 设置 需要 下 清 两 次 。 
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图 27-2 访问 快捷 设置 界面 
点 击 Wi-Fi 校 钮 禁用 Wi-Fi 网 络 ， 强 制 模拟 器 设备 使 用 蜂窝 网 络 〈 按 流量 


计 费 ) 。 


禁用 Wi-Fi 网 络 后 ， 再 次 运 s 行 PhotoGallery 应 用 。 这 次 ， 你 应 该 看 不 到 来 
ÉiPollworkerll] Fl T. 继续 学 习 之 前 ， 记 得 重新 启动 Wi-Fi 网 络 。 


27.3. Ts REA 


既然 PollWorker 运 行 起 来 没 问 题 了 7， 那 么 sSNA dE ES 
的 代码 逻辑 。 首 先 ， 你 需要 设法 保存 用 户 已 查看 的 最 新 图 片 ID 。 然 后 ， 
更 新 PollWorker 类 获取 新 图 片 ， 并 与 保存 的 图 片 ID 相 比 较 。 如 果 已 有 
搜索 结果 ， 那 么 PollWorker 还 要 决定 该 发 送 哪 种 网 络 请 求 。 


现在 ， 先 来 更 新 QueryPreferences 类 ， 实 现 保存 最 新 图 片 ID， 以 及 从 
shared preferences 取 出 保存 的 最 新 图 片 ID， 如 代码 清单 27-5 所 示 。 


代码 清单 27-5 ”保存 最 新 图 片 ID CQueryPreference.kt ) 


private const val PREF SEARCH QUERY = "searchQuery" 
private const val PREF LAST RESULT ID = "lastResultId" 


object QueryPreferences { 


fun setStoredQuery(context: Context, query: String) { 


} 


fun getLastResultId(context: Context): String { 
return PreferenceManager.getDefaultSharedPreferences (context) 
.getString(PREF LAST RESULT ID, "")!! 
} 


fun setLastResultId(context: Context, lastResultId: String) { 
PreferenceManager.getDefaultSharedPreferences(context).edit { 
putString(PREF LAST RESULT ID, lastResultId) 


与 第 26 章 的 做 法 一 样 ， 这 里 ， 因 
为 getString(PREF_LAST_RESULT_ID，"") 不 会 返回 空 字 符 串 ， 所 以 
在 getLastResultId(...) 函 数 里 ， 从 默认 的 SharedPreferences 实 


例 读 取 最 新 结果 图 片 ID 时 ， 使 用 了 非 空 断言 操作 符 〈!1) 。 


搞定 了 图 片 ID 的 存储 ， 接 下 来 是 以 轮 询 的 方式 获取 新 图 片 。 你 需要 更 新 
Fl1ickrFetchr， 人 允许 PollNorker 执 行 同 步 网 络 请 求 。 当 

前 ，fetchPhotos() 和 searchPhotos() 这 两 个 方 函数 都 是 执行 异步 网 
络 请 求 并 使 用 LiveData 发 布 结果 。 既 然 PollWorker 要 在 后 台 线 程 上 执 
行 ， 它 要 执行 的 网 络 请 求 就 不 应 让 FLickrFetchr 来 做 。 如 代码 清单 27- 
6 所 示 ， 更 新 FlickrFetchr 类 ， 把 Retrofit Cal1 对 象 暴 露出 来 给 
PollWorker 使 用 。 


代码 清单 27-6 ”暴露 Cal1 对 象 (FlickrFetchr.kt) 


class FlickrFetchr ( 


fun fetchPhotosRequest(): Call«FlickrResponse» ( 
return flickrApi.fetchPhotos() 
} 


fun fetchPhotos(): LiveData<List<GalleryItem>> { 


return fetchPhotoMetadata(fetchPhotosRequest()) 
} 


fun searchPhotosRequest(query: String): Call<FlickrResponse> { 
return flickrApi.searchPhotos (query) 


} 


fun searchPhotos(query: String): LiveData<List<GalleryItem>> { 


有 了 FlickrFetchr 中 的 Call 对 象 ， 束 可 以 把 查询 添加 给 PollWorker 
了 。 判 断 是 否 已 有 查询 结果 保存 ， 你 需要 让 PollWorker 知 道 该 发 送 哪 
种 网 络 请 求 。 一 旦 获取 最 新 图 片 ， 你 需要 检查 最 新 图 片 ID 和 你 之 前 保存 


的 是 否 一 臻 。 如 果 不 匹 配 ， 就 通知 用 户 。 


如 代码 清单 27-7 所 示 ， 首 先 从 QueryPreferences 中 获取 当前 搜索 查询 
以 及 上 一 次 最 新 图 片 ID。 如 果 没 有 读 取 到 搜索 查询 ， 就 正常 抓 取 图 片 ; 
如 果 有 搜索 查询 ， 就 执行 搜索 网 络 请 求 。 安 全 起 见 ， 你 需要 使 用 一 个 空 

合 ， 以 防 所 有 的 网 络 请 求 都 返回 不 了 任何 图 片 。 最 后 ， 删 除 之 前 测试 
用 的 日 志 打印 语句 。 


代码 清单 27-7 获取 最 新 图 片 CPollWorker.kt) 


class PollWorker(val context: Context, workerParameters: WorkerParameters) 
: Worker(context, workerParameters) ( 


override fun doWork(): Result { 


val query = QueryPreferences.getStoredQuery(context) 
val lastResultId = QueryPreferences.getLastResultId(context) 
val items: List<GalleryItem> = if (query.isEmpty()) { 
FlickrFetchr().fetchPhotosRequest() 
.execute() 
.body() 
?.photos 
?.galleryItems 
) else { 
FlickrFetchr().searchPhotosRequest (query) 
.execute() 
.body() 
?.photos 
?.galleryItems 
) ?: emptyList() 
return Result.success() 


接 下 来 ， 如 果 没 有 获取 到 任何 图 片 ， 就 从 doNork() 函 数 里 返回 。 人 否 
则 ， 就 抓 取 集合 里 的 第 一 个 最 新 图 片 ID， 并 与 1astResultId 属 性 值 做 
比较 。 为 了 看 到 PollNWorker 的 输出 ， 添 加 相应 的 日 志 输 出 语句 。 另 
外 ， 如 果 发 现 最 新 图 片 ， 就 更 新 QueryPreferences 里 保存 的 上 一 次 最 
新 图 片 ID， 如 代码 清单 27-8 所 示 。 


代码 清单 27-8 ”检查 新 图 片 (PollWorker.kt ) 


class PollWorker(val context: Context, workerParameters: WorkerParameters ) 
: Worker(context, workerParameters) ( 


override fun doWork(): Result { 
val query = QueryPreferences.getStoredQuery(context) 
val lastResultId = QueryPreferences.getLastResultId(context) 
val items: List<GalleryItem> = if (query.isEmpty()) { 


) else ( 


} 


if (items.isEmpty()) { 
return Result.success() 


} 


val resultId = items.first().id 
if (resultId == lastResultId) ( 
Log.i(TAG, "Got an old result: $resultId") 
) else { 
Log.i(TAG, "Got a new result: $resultId") 
QueryPreferences.setLastResultId(context, resultId) 
} 


return Result.success() 


在 实体 设备 或 模拟 器 上 运行 PhotoGallery 应 用 。 如 果 是 第 一 次 运 

行 ，QueryPreferences 里 则 没有 最 新 图 片 D。 从 日 志 可 以 看 

到 ，PollWorker 没 有 发 现 新 结果 。 如 果 快 速 重新 运行 应 用 ， 你 应 该 就 
能 看 到 PollWorker 找 到 了 同样 的 最 新 图 片 DD。 注意 ， 如 图 27-3 所 
示 ，Logcat 应 该 设置 为 No Filters， 和 否则 你 会 看 不 到 日 志 。) 


II Emulator Boos Screens; comblynerdranchandrod.ph) Verbose (d Ol PolWorker E Regen No Filters tj 


& 2019-01-16 12:30:44,280 16089-16921/con, bignerdranch. android, photogallery 1/PollWorker: Got a new result: 31624924597 
3 2019-01-16 12:30:44,284 16089-16906/con, bignerdranch, android, photogallery I/W-WorkerWrapper: Worker result SUCCESS for Work [ 
id=2e98d6f0-d62e-407a-Jccc-c9c3c46f97f5, tags={ con, bignerdranch, android, photogallery, Pollyorker } ] 
2019-01-16 12:30:49,203 16943-16972/con. bignerdranch, android, photogallery I/PollWorker: Got an old result: 31824924597 
= 2019-01-16 12:30:49,206 16943-16954/con, bignerdranch, android photogallery T/W-Workerirapper: Worker result SUCCESS for Work | 
e id=7dc28b5F-1086~4c7d-afd5-e8602067d411, tags={ con.bignerdranch.android, photogallery, Polorker ) ] 


G 


图 27-3 ”搜索 新 旧 图 片 


27.4 通知 用 户 


你 的 Worker 服 务 已 在 后 台 运 行 ， 执 行 着 发 现 新 图 片 的 任务 ， 不 过 用 户 对 
此 至 不 知情 。 如 果 PhotoGallery 应 用 检查 到 新 图 乒 ， 并 且 知 道 用 户 还 没 
Ail, ERD PII VARESE 


应 用 需要 与 用 户 沟通 ， 一 般 都 是 使 用 通知 (notification) 这 个 工具 。 通 
知 是 指 显示 在 通知 抽 居 上 的 消 恩 条 目 ， 用 户 可 从 屏幕 顶部 问 下 滑动 查看 
通知 。 


要 在 运行 Android Oreo (API 级 别 26) 及 更 高 版 本 系统 的 设备 上 创建 通 
知 ， 首 先 必须 创建 一 个 渠道 (Channel) 。 渠 道 能 分 类 管理 通知 ， 提 供 
更 精细 的 通知 偏好 控制 管理 。 相 比 之 前 只 有 关闭 整个 应 用 才能 通知 一 个 
选项 ， 用 户 现 在 可 以 选择 只 关闭 应 用 的 某 一 类 通知 。 男 外 ， 用 户 还 能 按 
渠道 定制 静音 、 震 动 等 其 他 通知 设置 渠道 。 


例如 ， 你 获取 到 了 新 的 可 爱 动 物 图 片 : 小 猫 、 小 狗 以 及 其 他 小 动物 。 根 
据 分 类 ， 你 希望 PhotoGallery 能 发 送 三 类 通知 。 这 很 简单 ， 创 建 三 个 渠 
道 ， 每 个 渠道 对 应 一 种 通知 分 类 束 可 以 了 ， 剩 下 的 让 用 户 按 上 自己 喜好 配 
置 ， 如 图 27-4 所 示 。 
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图 27-4” 按 渠道 精细 化 配置 通知 


Asc fF Android Oreo 及 更 高 版 本 的 新 系统 ， 你 的 应 用 至 少 要 创建 一 个 通 
知 渠 道 。 虽 然 Android 不 限制 应 用 可 以 配置 的 通知 渠道 数 ， 但 你 也 应 本 
着 够 用 且 合 理 的 原则 去 配置 。 要 知道 ， 引 入 通知 渠道 就 是 让 用 户 按 应 用 
配置 通知 ， 太 多 的 渠道 反而 会 让 用 户 无 所 适 从 ， 感 觉 很 糟 料 。 


如 代码 清单 27-9 所 示 ， 添 加 一 个 名 为 PhotoGalleryApplication 的 新 

类 ， 让 它 继承 Application 父 类 ， 并 禾 新 其 ‘Application. onCreate() 

函数 ， IE EH ACIE Android Orea E MRA EE 云 行 ， 就 创建 一 个 
通知 渠道 


代码 清单 27-9 创建 通知 渠道 (PhotoGalleryApplication.kt ) 


const val NOTIFICATION CHANNEL ID = "flickr poll" 


class PhotoGalleryApplication : Application() { 


override fun onCreate() ( 
super.onCreate() 
if (Build.VERSION.SDK INT »- Build.VERSION CODES.O) { 
val name - getString(R.string.notification channel name) 
val importance - NotificationManager.IMPORTANCE DEFAULT 
val channel - 


NotificationChannel(NOTIFICATION CHANNEL ID, name, impo 
val notificationManager: NotificationManager = 

getSystemService(NotificationManager::class.java) 
notificationManager.createNotificationChannel(channel) 


通知 渠道 名 会 显示 在 应 用 通知 设置 界面 (图 27-4) ， 是 用 户 看 得 见 的 字 
符 串 。 打 开 res/values/strings.xml 文 件 ， 添 加 需要 的 字符 串 资 源 用 于 通知 
渠道 名 。 男 外 ， 再 顺手 添加 一 些 通 知 消息 需要 的 其 他 字符 串 资 源 ， 如 代 
码 清单 27-10 所 示 。 


代码 清单 27-10 ”添加 字符 串 资源 Cres/values/strings.xml ) 


<resources> 
<string name="clear_search">Clear Search</string> 
<string name="notification_channel_name">FlickrFetchr</string> 
«string name-"new pictures title"»New PhotoGallery Pictures</string> 
«string name-"new pictures text"»You have new pictures in PhotoGallery. 
</resources> 


接 下 来 ， 更 新 manifest 文 件 ， 指 向 刚才 新 建 的 
PhotoGalleryApplication 类 ， 如 代码 清单 27-11 所 示 。 


代码 清单 27-11 ”更 新 manifest 文 件 的 application 标 签 
(manifests/AndroidManifest.xml ) 


<manifest ... > 


<application 
android:name=".PhotoGalleryApplication" 
android: allowBackup="true" 
"E 


</application> 
</manifest> 


要 想 发 送 通知 ， 首 先 要 创建 Notification 对 象 。 与 第 13 章 的 
AlertDialog 类 似 ，Notification 需 使 用 构造 对 象 来 创建 。 完 整 的 
Notification 至 少 应 包括 以 下 内 容 : 


在 状态 栏 上 显示 的 图 标 (icon) ; 

代表 通知 信息 上 自身 在 通知 抽 屈 中 显示 的 视图 (view) ; 
用 户 点 击 抽 居中 的 通知 时 会 触发 的 PendingIntent; 

用 来 应 用 样式 ， 提 供用 户 通 知 控制 的 NotificationChannel。 


另外， 你 还 需要 给 通知 添加 记号 文字 (ticker text) 。 记 号 文字 不 会 随 通 
知 显示 ， 但 会 被 发 送 给 Android 辅 助 服 务 使 用 ， 例如 ， 屏幕 阅读 器 会 用 
它 通 知 有 视力 障碍 的 用 户 。 


完成 Notification 对 象 的 创建 后 ， 可 调用 NotificationManager 系 统 
Lx E Notification) 函 数 发 送 它 。 这 里 的 Int 参 数 就 
是 应 用 通知 的 ID。 


首先 是 基础 代码 准备 。 在 PhotoGalleryActivity.kt 中 ， 添 加 一 
‘newIntent (Context) ria, WSs 427-12 AN. VA PK ALEK [n] 
一 个 可 用 来 启动 PhotoGalleryActivity 的 Intent 实 例 。 (最 

Ja, Pollworker& iH HPhotoGalleryActivity.newIntent(...) BK 
数 ， 把 返回 结果 封装 在 一 个 PendingIntent 中 ， 然 后 设置 给 通知 消 
E.) 


代码 清单 27-12 ”给 PhotoGalleryActivity 添 加 newIntent(...) 
函数 〈PhotoGalleryActivity.kt ) 


class PhotoGalleryActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


companion object { 
fun newIntent(context: Context): Intent { 
return Intent(context, PhotoGalleryActivity::class.java) 


接着 ， 一 旦 有 了 新 结果 ， 就 让 PollWorker 通 知 用 户 。 也 就 是 说 ， 创 建 
一 个 Notification 对 象 ， 并 调 

用 NotificationManager.notify(Int，Notification) 函 数 ， 如 代 
码 清单 27-13 所 示 。 


代码 清单 27-13 ”添加 一 个 Notification (PollWorker.kt) 


class PollWorker(val context: Context, workerParameters: WorkerParameters ) 
: Worker(context, workerParameters) ( 


override fun doWork(): Result { 


val resultId = items.first().id 

if (resultId -- lastResultId) ( 
Log.i(TAG, "Got an old result: $resultId") 

) else { 
Log.i(TAG, "Got a new result: $resultId") 
QueryPreferences.setLastResultId(context, resultId) 


val intent = PhotoGalleryActivity.newIntent (context) 
val pendingIntent = PendingIntent.getActivity(context, 0, inten 


val resources = context.resources 

val notification = NotificationCompat 
.Builder(context, NOTIFICATION CHANNEL ID) 
.setTicker(resources.getString(R.string.new pictures title) 
.setSmallIcon(android.R.drawable.ic menu report image) 
.setContentTitle(resources.getString(R.string.new pictures 
.setContentText(resources.getString(R.string.new pictures t 
.setContentIntent(pendingIntent) 
.setAutoCancel(true) 
.build() 


val notificationManager = NotificationManagerCompat.from(contex 
notificationManager.notify(0, notification) 


} 


return Result.success() 


我 们 从 上 至 下 解读 一 下 新 增 代码 。 


为 了 同时 支持 新 老 设备 ， 这 里 使 用 了 NotificationCompat 类 。 如 果 设 
备 运行 的 是 Oreo 或 它 之 后 的 系统 ，NotificationCompat .Builder 会 
使 用 传 入 的 渠道 ID 设置 通知 渠道 如果 设 备 运 行 的 是 Oreo 之 前 的 系 

统 ，NotificationCompat.Builder 则 会 包 略 渠道 。 注意， 这 里 使 
用 的 渠道 ID 是 在 PhotoGalleryApplication 里 添加 的 
NOTIFICATION_CHANNEL_ID 常 量 。) 


在 代码 清单 27-9 里 ， 创 建 渠道 之 前 ， 你 需要 检查 SDK 编 译 版 本 ， 因 为 没 
有 用 于 创建 渠道 的 AppCompat API。 这 里 之 所 以 不 需要 ， 是 因为 

AppCompat 的 NotificationCompat 帮 你 做 了 版 本 检查 ， 代 码 因此 更 简 
is 易 读 了 。 这 也 是 我 们 一 直 推 荐 使 用 AppCompat 版 Android API 的 一 个 理 


为 配置 记号 文字 和 小 图 标 ， 我 们 调用 setTicker(CharSequence) 和 
setSmal1Icon(Int) 函 数 。 (注意 ， 以 
android.R.drawable.ic_menu_report_image 包 名 形式 引用 的 图 标 资源 已 内 
H T Android framework 中 ， 束 没 必 要 再 单独 放 入 资源 文件 夹 了 。) 


然后 ， 配 置 Notification 在 下 拉 抽 屠 中 的 外 观 。 虽 然 可 以 定 

制 Notification 视 图 的 外 观 和 样式 ， 但 使 用 这 有 图 标 、 标 题 以 及 文字 
显示 区 域 的 标准 视图 会 更 容易 些 。 图 标的 值 来 自 setSmal1Icon(Int) 
函数 ， 而 设置 标题 和 显示 文字 需 分别 调 

用 setContentTitle(CharSequence) 和 

setContentText (CharSequence) 函数 。 


接 下 来 ， 需 指定 用 户 点 击 Notification 时 所 触发 的 动作 行为 。 这 里 使 
用 的 是 PendingIntent 对 象 。 用 户 在 下 拉 抽 居中 点 击 Notification 
IN, 4@AsetContentIntent (PendingIntent) MAX hyPendingIntent 
会 被 触发 。 调 用 setAutoCancel(true) 函 数 可 调整 上 述 行 为 。 一 旦 执 
行 了 setAutoCancel(true) 设 置 函数 ， 用 户 点 击 Notification 时 ， 该 
通知 就 会 从 通知 抽 居 中 删除 。 


最 后 ， 从 当前 context (NotificationManagerCompat.from) 中 取出 
一 个 NotificationManager 实 例 ， 并 调 
HjNotificationManager.notify(...)P ZI A pil AH. 


传 入 notify(...) 函 数 的 整数 参数 是 通知 的 标识 符 。 该 值 在 整个 应 用 中 
应 该 是 唯一 的 ， 但 可 复 用 。 如 末 使 用 同一 ID 发 送 两 条 通知 ， 则 第 二 条 通 
知 会 答 换 第 一 条 通知 ;如 果 没 有 同样 ID 的 通知 ， 系 统 就 会 展示 一 个 新 的 
通知 。 在 实际 开发 中 ， 这 也 是 进度 条 或 其 他 动态 视觉 效果 的 实现 方式 。 


至此， 终于 搞定 了 消息 通知 。 现 在 运行 应 用 。 你 应 该 马上 就 会 看 到 状态 
栏 的 通知 图 标 ， 如 图 27-5 所 示 。 
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图 27-5 ”新 图 片 通知 
27.5 ”服务 的 用 户 控 制 


有 些 用 户 不 豆 欢 应 用 在 后 台 运 行 。 你 应 该 提供 功能 ， 让 用 户 目 己 控制 局 
停 后 台 轮 询 服 务 。 
对 于 PhotoGallery 应 用 ， 我 们 会 在 它 的 工具 栏 上 添加 选项 菜单 ， 让 用 户 


启 停 Worker 服 务 。 男 外 ， 还 会 更 新 Worker 服 务 ， 让 它 定 期 运行 ， 而 不 是 
只 运行 一 次 。 


为 了 局 停 Worker 服 务 ， 首 先 要 能 判断 服务 当前 是 否 正 在 运行 。 为 此 ， 我 
们 使 用 QueryPreferences 保 存 一 个 表示 服务 是 否 启 用 的 标志 ， 如 代码 
清单 27-14 所 示 。 


代码 清单 27-14 ”保存 服务 状态 (QueryPreferences.kt) 


private const val PREF SEARCH QUERY = "searchQuery" 
private const val PREF LAST RESULT ID = "lastResultId" 
private const val PREF IS POLLING - "isPolling" 


object QueryPreferences { 


fun setLastResultId(context: Context, lastResultId: String) { 


} 


fun isPolling(context: Context): Boolean { 
return PreferenceManager.getDefaultSharedPreferences (context) 
.getBoolean(PREF_IS POLLING, false) 


} 


fun setPolling(context: Context, isOn: Boolean) { 
PreferenceManager.getDefaultSharedPreferences(context).edit { 
putBoolean(PREF_IS POLLING, isOn) 


PR Jc S LIP USE For BEE AB, ON a ed, — T HT 
止 轮 询 ， 如 代码 清单 27-15 所 示 。 


代码 清单 27-15 ”添加 轮 询 字符 串 资 源 Cres/values/strings.xml ) 


<resources> 


«string name-"new pictures text"»You have new pictures in PhotoGallery. 


«string name-"start polling"»Start polling«/string» 
«string name-"stop polling"»Stop polling</string> 
</resources> 


添加 完 字 符 串 资源 ， 打 开 res/menu/fragment_photo _gallery.xml 菜 单 文 
件 ， 添 加 启 停 服 务 的 菜单 项 ， 如 代码 清单 27-16 所 示 。 


代码 清单 27-16 ”添加 启 停 服务 菜单 项 


(res/menu/fragment_photo_gallery.xml ) 


<?xml version-"1.0" encoding-"utf-8"?» 
«menu xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 


«item android:id="@+id/menu_item_clear" 
android: title="@string/clear_search" 
app: showAsAction="never" /> 


android: id="@+id/menu_item_toggle polling" 

android: title="@string/start_polling" 

app: showAsAction="ifRoom|withText"/> 
</menu> 


服务 选项 菜单 默认 显示 着 start_polling。 你 应 该 切换 选项 菜单 标题 ， 
以 便 和 后 台 服 务 局 停 状 态 匹配 。 打 开 PhotoGalleryFragment.kt 文 件 ， 

在 onCreateOptionsMenu(...) 函 数 中 ， 检 查 后 人 台 服 务 的 启 停 状 态 ， 然 
后 相应 地 更 新 menu_item_toggle_polling 的 标题 文字 ， 将 正确 的 信息 
反馈 给 用 户 。 另 外 ， 记 得 从 onCreate(. . .) 函 数 里 删除 不 需要 的 
OneTimeNorkRequest 逻 辑 ， 如 代码 清单 27-17 所 示 。 


代码 清单 27-17 KAMY (PhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : Fragment() { 


override fun onCreate(savedInstanceState: Bundle?) { 


lifecycle.addObserver(thumbnailDownloader) 


— enqueue twerkRequest) 
} 
override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) { 
scar chile apply 1 
are 


val toggleItem = menu.findItem(R.id.menu item toggle polling) 
val isPolling = QueryPreferences.isPolling(requireContext()) 
val toggleltemTitle = if (isPolling) { 


R.string.stop_polling 
} else { 


R.string.start_polling 
} 


toggleItem.setTitle(toggleItemTitle) 


最 后 ， 更 新 on0ptionsItemselected(...) 函 数 响 应 菜单 项 服务 启 停 
点 击 ， 如 果 Worker 服 务 没 有 运行 ， 束 创建 一 个 新 
PeriodicWorkRequest， 用 WorkManager 调 度 管理 它 ;， 如 果 Worker 服 


务 处 于 运行 状态 ， 束 集 掉 它 ， 如 代码 清单 27-18 所 示 。 


代码 清单 27-18” 啊 应 菜单 项 服务 局 停 点 击 
( PhotoGalleryFragment.kt ) 


private const val TAG - "PhotoGalleryFragment" 
private const val POLL WORK = "POLL WORK" 


class PhotoGalleryFragment : Fragment() { 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
return when (item.itemId) { 
R.id.menu item clear -> ( 


photoGalleryViewModel.fetchPhotos("") 
true 


} 

R.id.menu_item_toggle_polling -> { 
val isPolling = QueryPreferences.isPolling(requireContext()) 
if (isPolling) { 


WorkManager .getInstance().cancelUniquework(POLL_WORK) 

QueryPreferences.setPolling(requireContext(), false) 
} else { 

val constraints = Constraints.Builder() 


. setRequiredNetworkType(NetworkType.UNMETERED) 
.build() 

val periodicRequest = PeriodicWorkRequest 
.Builder(PollWorker::class.java, 15, TimeUnit.MINUTE 
.setConstraints(constraints) 
.build() 


WorkManager.getInstance().enqueueUniquePeriodicWork(POLL 
ExistingPeriodicWorkPolicy.KEEP, 
periodicRequest) 


QueryPreferences.setPolling(requireContext(), true) 


} 
activity?.invalidateOptionsMenu() 
return true 

j 


else -» super.onOptionsItemSelected(item) 


首先 来 看 新 增 代码 的 else 代 码 块 。 如 果 Worker 服 务 当前 未 运行 ， 就 让 
WorkManager 调 度 一 个 新 的 Worker 请 求 。 这 里 ， 你 使 

用 PeriodicWorkRequest 类 让 Worker 服 务 以 一 定 的 时 间 间 隔 发 起 周期 
性 请 求 。 和 之 前 使 用 的 0neTimeWorkRequest 一 样 ， 这 个 Worker 请 求 也 
使 用 构造 器 (需要 PeriodicWorkRequest 类 和 时 间 间 隔 这 两 个 参 

数 ) 。 


这 里 设置 的 15 分 钟 时 间 间 隔 有 点 长 。 如 果 试 着 改 短 一 点 儿 ， 你 会 发 现 ， 
Worker 服 务 还 是 会 以 15 分 钟 的 时 间 间 隔 运行 。 实 际 上 ， 这 
是 PeriodicWorkRequest 人 允许 的 最 小 时 间 间 隔 ， 以 防止 系统 过 于 频繁 
地 执行 同一 任务 ， 从 而 节约 系统 资源 一 一 设备 电池 寿命 。 


和 OneTimeWorkRequest 一 样 ，PeriodicWorkRequest 构 造 嚣 也 支持 
添加 不 计 流 量 网 络 要 求 约束 。 需 要 调度 安排 Worker 请 求 时 ， 一 般 使 
用 NorkManager 类 ， 但 这 里 使 用 的 

是 enqueueUniquePeriodicwork(...) 函 数 。 该 函数 需要 三 个 参数 ; 
一 个 string 类 型 的 名 称 、 一 个 当前 服务 策略 以 及 你 的 网 络 服务 请 求 。 
名 称 参 数 允 许 你 唯一 地 标识 你 的 网 络 服务 请 求 〈 停 止 服务 时 引用 ) 。 


当前 服务 策略 告诉 WorkManager 该 如 何 对 待 已 计划 安排 好 的 具名 工作 任 
务 。 这 里 使 用 的 是 KEEP 策 略 ， 意 思 是 保留 当前 服务 ， 不 接受 安排 新 的 
后 台 服 务 。 当 前 服务 策略 的 另 一 个 选择 是 REPLACE， 顾 名 思 义 ， 束 是 
使 用 新 的 后 台 服 务 蔡 换 当前 服务 。 


如 果 你 的 Worker 后 台 服 务 已 经 在 运行 ， 那 么 就 得 让 WorkManager 撤 销 
它 。 这 里 ， 给 cancelUniqueWork(...) 传 入 POLL_WORK” 服 务 名 以 
删除 你 的 周期 性 工作 任务 。 


运行 PhotoGallery 应 用 。 你 应 该 能 看 到 局 停 轮 询 服务 的 染 单 选项 。 如 果 
不 想 兰 等 15 分 钟 ， 你 现在 就 可 以 葵 用 轮 询 服 务 ， 等 上 几 秒 ， 然 后 重 局 


IM 


Kio 


现在 ， 即 使 没有 运行 ，PhotoGallery 应 用 也 能 让 用 户 知道 是 否 有 新 图 片 
可 看 。 但 有 个 问题 不 容 忽 视 : 每 次 有 了 新 图 片 ， 用 户 就 会 收 到 通知 一 一 
即使 打开 应 用 也 是 如 此 。 这 会 分 散 用 户 的 注意 力 ， 非 常 不 可 取 。 而 且 ， 
m HEUREUSE 还 会 启动 多 余 的 PhotoGalleryActivity 新 实 
列 。 


下 一 章 会 更 新 应 用 来 解决 这 个 问题 ， 以 实现 只 要 PhotoGallery 应 用 还 在 
运行 ， 系 统 就 阻止 后 台 轮 询 服 务 发 送 通 知 。 在 应 用 更 新 过 程 中 ， 你 将 学 
习 如 何 监听 broadcast intent， 以 及 如 何 使 用 broadcast receiver 来 处 理 
broadcast intent. 


= 28 = broadcast intent 


用 户 开 了 应 用 ， 已 看 到 新 的 搜索 图 片 ， 同 时 还 收 到 了 新 图 片 更 新 通知 ， 
你 说 是 不 是 既 多 余 义 烦人 ? 本章， 我 们 继续 优化 PhotoGallery 应 用 ， 让 
用 户 正 在 使 用 应 用 时 ， 不 再 收 到 新 图 片 更 新 通知 。 


借 此 升级 ， 你 将 学 习 如 何 监听 系统 发 送 的 broadcast intent， 以 及 如 何 使 
用 broadcast receiver 处 理 它们 。 此 外 ， 还 会 学 习 如 何在 应 用 运行 时 动态 
发 送 与 接收 broadcast intent， 以 及 如 何 使 用 有 序 broadcast 判 断 应 用 是 否 在 


前 台 运 行 。 


28. 普通 intent 与 broadcast intent 


在 Android 设 备 中 ， 各 种 事件 时 有 发 生 ， 例 如 ，Wi-Fi 时 有 时 无 、 软 件 装 
E, BERI, WEWER, SE. 


许多 系统 组 件 需要 掌握 这 些 事件 动态 ， 以 便 按 需 啊 应 。 为 满足 这 样 的 需 
求 ，Android 提 供 了 broadcast intent 组 件 。 


上 述 所 有 事件 广播 都 是 由 系统 及 出 的 ， 所 以 又 叫 系统 广播 。 你 也 可 以 及 
送 和 接收 自己 的 定制 广播 。 不 过 ， 系 统 广播 和 定制 广播 的 接收 原理 不 一 
样 。 本 章 ， 我 们 只 会 使 用 定制 广播 。 


broadcast intent 的 工作 原理 类 似 之 前 学 过 的 intent， 唯 一 不 同 的 是 
broadcast intent FJ 同时 被 多 个 叫 作 broadcast receiver 的 组 件 接收 ， 如 图 28- 
1 所 示 。 


Intents Broadcast intents 


PhotoGallery — | (你 的 组 件 ) (Reheat) 
一 一 一 htentDO SOMETHNG) 一 - 一 — inen(SOMETHNG HAPPENED) — 一 一 一 
Android lE 


Y 


BEI NM a 
(EB) 


图 28-1 普通 jintent 与 broadcast intent 


作为 公共 API 的 一 部 分 ， 无 论 什 么 时 候 ，activity 和 服务 应 该 都 可 以 啊 应 
隐 式 intent。 如 果 是 用 作 私 有 API， 使 用 显 式 intent 差 不 多 也 够 了 了 。 既 然 这 
样 ， 如 果 还 需要 broadcast intent， 那 么 理由 只 有 一 个 : 它 可 以 发 送 给 多 

个 接收 者 。 虽 然 broadcast receiver 也 能 啊 应 显 式 intent， 但 几乎 没 人 这 人 么 

用 ， 因 为 显 式 intent 只 允许 有 一 个 接收 者 。 


28.2 ”过 滤 前 台 通 知 


通知 虽然 很 有 用 ， 但 在 应 用 开 着 的 时 候 还 有 通知 就 不 好 了 。 不 过 ， 可 以 
使 用 broadcast intent 来 改变 PollWorker 的 这 种 行为 。 


首先 ， 只 要 获取 到 新 图 片 ， 就 从 PollWorker 发 送 一 个 broadcast intent. 
然后 ， 我 们 登记 两 个 broadcast receiver。 第 一 个 登记 在 Android manifest 
文件 里 ， 只 要 接 到 PollWorker 发 来 的 broadcast， 它 就 像 之 前 一 样 给 用 


户 发 通知 。 第 二 个 改 用 代码 动态 登记 ， 只 在 用 户 打 开 应 用 时 才 激 活 。 它 
的 任务 是 阻止 广播 被 第 一 个 broadcast receiver 接 收 ( 收 不 到 消息 ， 自 然 
tA ART) o 


联合 两 个 broadcast receiver 做 一 件 事 看 起 来 不 太 寻 常 。 不 过 这 也 是 没 办 
法 的 事 ，Android 没 告诉 我 们 该 如 何 判 断 某 个 activity 或 fragment 是 否 正 在 
运行 。 既 然 PollWworker 不 知道 你 的 UI 是 否 处 于 可 见 状态 ， 自 然 也 就 无 
法 通过 条 件 判 断 来 决定 是 否 发 送 通 知 。 同 样 ， 你 也 无 法 判断 
PhotoGallery 是 否 打 开 ， 进 而 有 选择 地 发 送 广播 。 因 此 ， 我 们 想到 使 用 
两 个 broadcast receiver 互 相配 合 ， 只 让 其 中 一 个 啊 应 广播 来 控制 通知 发 


28.2.1 ”发送 broadcast intent 


首先 处 理 最 容易 的 部 分 : 发 送 上 自己 定制 的 broadcast intent. BKH, 

就 是 发 送 broadcast 告 诉 监 旷 组 件 有 新 的 搜索 结果 了 。 要 发 送 broadcast 

intent， 只 需 创 建 一 个 intent， 并 传 入 sendBroadcast(Intent) 函 数 即 
可 。 这 里 ， 需 要 通过 sendBroadcast(Intent) 函 数 广播 自 定 义 的 操作 
Caction) ， 因 此 还 需要 定义 一 个 操作 常量 。 


更 新 PollWorker 类 ， 输 入 代码 清单 28-1 所 示 代 码 。 
代码 清单 28-1 发送 broadcast intent (PollWorker.kt) 


class PollWorker(val context: Context, workerParams: WorkerParameters) : 
Worker(context, workerParams) { 


override fun doWork(): Result { 


val resultId = first().id 
if (resultId == lastResultId) ( 

Log.i(TAG, "Got an old result: $resultId") 
) else { 


val notificationManager = NotificationManagerCompat.from(contex 
notificationManager.notify(0, notification) 


context.sendBroadcast(Intent(ACTION SHOW NOTIFICATION)) 
j 


return Result.success() 


} 


companion object { 
const val ACTION SHOW NOTIFICATION = 
"com.bignerdranch.android.photogallery.SHOW NOTIFICATION" 


28.2.2 ”创建 并 登记 standalone receiver 


broadcast 发 送出 去 了 ， 还 要 有 人 监听 。 为 了 接收 broadcast， 我 们 创建 一 
个 BroadcastReceiver。Android 有 两 种 broadcast receiver， 这 里 要 创建 
的 是 一 个 standalone broadcast receiver。 


standalone receiver 是 一 个 在 manifest 配 置 文件 中 声明 的 broadcast 

receiver。 即 便 应 用 进程 已 消亡 ，standalone receiver 也 可 以 被 激活 。〔 稍 
后 还 会 学 习 到 可 以 同 fragment 或 activity 的 生命 周期 绑 定 的 dynamic 
receiver. ) 


与 服务 和 activity 一 样 ，broadcast receiver 必 须 在 系统 中 登记 后 才能 用 。 
如 果 不 登 记 ， 系 统 就 不 知道 该 同 哪 里 发 送 intent。 自 然 ，broadcast 
receiver 的 onReceive(...) 函 数 也 就 不 能 按 预 期 被 调用 了 。 


登记 broadcast receiver 之 前 ， 首 先 要 创建 它 。 创 建 一 个 名 
为 NotificationReceiver 的 Kotlin 新 类 ， 让 它 继 
承 android.content.BroadcastReceiver 类 ， 如 代码 清单 28-2 所 示 。 


代码 清单 28-2 ”你 的 第 一 个 broadcast 
receiver (NotificationReceiver.kt ) 


private const val TAG = "NotificationReceiver" 


class NotificationReceiver : BroadcastReceiver() ( 


override fun onReceive(context: Context, intent: Intent) ( 
Log.i(TAG, "received broadcast: $(intent.action)") 


} 


与 服务 和 activity 一 样 ，broadcast receiver 是 接收 intent 的 组 件 。 当 有 intent 


发 送 给 NotificationReceiver 时 ， 它 的 onReceive(...) 函 数 会 被 调 
用 。 


接 下 来 ， 打 开 manifests/AndroidManifest.xml 配 置 文 件 ， 登 记 
NotificationReceiver 为 standalone receiver， 如 代码 清单 28-3 所 示 。 


代码 清单 28-3 ”在 manifest 文 件 中 添加 


receiver (manifests/AndroidManifest.xml ) 


<application ... > 
«activity android:name=".PhotoGalleryActivity"> 


</activity> 
<receiver android:name=".NotificationReceiver"> 
</receiver> 

</application> 


要 有 选择 地 接收 broadcast，receiver 还 要 有 intent filter。 除 了 过 滤 对 象 不 
一 样 (broadcast intent 和 普通 intent 的 区 别 ) ， 这 里 要 添加 的 filter 和 之 前 
搭配 隐 式 intent 的 intent filter 没 什么 不 同 。 如 代码 清单 28-4 所 示 ， 添 加 一 
个 intent filter 使 其 只 接收 带 SHOW_NOTIFICATION 操 作 的 intent。 


代码 清单 28-4 给 receiver 添 加 intent 
filter Cmanifests/AndroidManifest.xml ) 


<receiver android:name=".NotificationReceiver"> 
<intent-filter> 
<action 


android :name="com.bignerdranch. android. photogallery.SHOW_NOTIFIC 
</intent-filter> 
</receiver> 


现在 ， 如 果 在 Android Oreo 或 更 高 版 本 系统 的 设备 上 运行 PhotoGallery 应 
用 ， 你 看 不 到 预期 的 日 志 。 事 实 上 ，NotificationReceiver 的 
onReceive(... ) 函 数 根 本 没有 被 调用 。 但 在 旧版 本 Android 系 统 上 试 一 
下 ， 你 会 发 现代 码 执 行 完 全 符合 预期 。 实 际 上 ， 这 是 新 版 本 Android 系 
统 对 broadcast 的 一 个 限制 。 不 过 ， 不 用 担心 ， 目 前 所 做 的 工作 并 非 徒 
稍 后 ， 通 过 发 送 一 个 带 权 限 的 broadcast， 你 可 以 绕 开 新 系统 的 限 
lo 


28.2.3 ”使 用 私有 权限 限制 broadcast 


使 用 broadcast receiver 存 在 一 个 问题 ， 即 系统 中 的 任何 应 用 都 能 监听 或 
者 触发 你 的 receiver。 通 种 来 讲 ， 这 都 不 是 你 希望 看 到 的 。 给 broadcast 指 
定 权 限 还 能 解决 NotificationReceiver 无 法 在 新 版 本 系统 上 工作 的 问 


jel 


为 了 阻止 未 授权 应 用 冯 入 你 的 私人 领域 ， 你 可 以 给 receiver 应 用 定制 权 
限 ， 以 及 给 receiver 标 签 添加 一 个 android:exported="false" 属 性 。 
这 样 ， 系 统 中 的 其 他 应 用 就 再 也 无 法 接触 到 该 receiver 了。 应 用 权限 之 
后 ， 只 有 请 求 授 权 并 被 授权 的 组 件 才 能 发 送 broadcast 给 你 的 receiver。 


首先 ， 在 AndroidManifest.xml 文 件 中 ， 声 明 并 获取 自己 的 使 用 权限 ， 如 
代码 清单 28-5 所 示 。 


代码 清单 28-5 ”添加 私有 权限 Cmanifests/AndroidManifest.xml ) 


<manifest ...> 


«permission android:name-"com.bignerdranch.android.photogallery.PRIVATE 
android:protectionLevel-"signature" /» 


<uses-permission android:name="android.permission. INTERNET" /> 
<uses-permission android:name="com.bignerdranch.android.photogallery.PR 


</manifest> 


以 上 代码 中 ， 你 使 用 protection level 签 名 定义 了 自己 的 定制 权限 。 稍 
后 ， 还 会 学 习 到 更 多 有 关 protection level 的 知识 。 如 同 前 面 用 过 的 intent 
操作 、 类 别 和 系统 权限 ， 权 限 本 喘 只 是 一 行 简单 的 字符 串 。 制 定 了 权限 
之 后 ， 哪 怕 是 自己 定义 的 权限 ， 你 都 必须 申请 使 用 权限 。 这 是 规则 。 


注意 查看 上 面 代 码 中 灰色 加 亮 常量 值 。 这 是 定制 权限 的 唯一 标识 字符 
串 。 你 会 在 manifest 里 各 处 使 用 它 指 代 你 定制 的 权限 。 男 外 ， 需 要 问 
receiver 发 送 broadcast intent 时 ， 你 还 会 在 Kotlin 代 码 里 使 用 它 。 无 论 出 现 
在 哪里 ， 这 个 唯一 标识 符 都 应 该 完全 一 样 ， 不 能 有 错 。 你 最 好 复制 粘 
贴 ， 而 不 是 手动 输入 它 。 


接 下 来 ， 给 receiver 标 签 应 用 权限 ， 并 设置 其 android:exported 属 性 值 


为 "false"， 如 代码 清单 28-6 所 示 。 
代码 清单 28-6 应 用 权限 并 设置 属性 值 


(manifests/AndroidManifest.xml ) 


<manifest ... > 


<application ... > 


«receiver android:name=".NotificationReceiver" 
android: permission="com.bignerdranch. android.photogallery| 
android:exported="false"> 


</receiver> 
</application> 
</manifest> 


现在 ， 为 使 用 权限 ， 在 代码 中 定义 一 个 对 应 常量 ， 然 后 将 其 传 
入 sendBroadcast(...) 函 数 ， 如 代码 清单 28-7 所 示 。 


代码 清单 28-7 发 送 带 有 权限 的 broadcast (PollWorker.kt) 


class PollWorker(val context: Context, workerParams: WorkerParameters) : 
Worker(context, workerParams) { 


override fun doWork(): Result { 


val resultId = first().id 
if (resultId == lastResultId) ( 

Log.i(TAG, "Got an old result: $resultId") 
) else { 


val notificationManager = NotificationManagerCompat.from(contex 
notificationManager.notify(0, notification) 


context.sendBroadcast(Intent(ACTION SHOW NOTIFICATION), PERM PR 
} 


return Result.success() 


} 


companion object { 
const val ACTION_SHOW_NOTIFICATION = 
"com.bignerdranch.android.photogallery.SHOW_NOTIFICATION" 


const val PERM PRIVATE = "com.bignerdranch.android.photogallery.PRI 


现在 ， 只 有 PhotoGallery 应 用 才能 触发 你 的 receiver。 再 次 运行 
PhotoGallery 应 用 。 查 看 Logcat 窗 口 ， 你 应 该 能 看 到 来 自 
NotificationReceiver 的 日 志 〔( 当 然 ， 和 之 前 一 样 ， 通 知 消息 还 是 不 
太 懂 规矩 ， 应 用 在 前 台 的 时 候 ， 它 仍 会 弹出 ) 。 


深入 学 习 安 全 级 别 


自 定义 权限 必须 指定 android:protectionLevel 属 性 值 。Android 根 
据 protectionLevel 属 性 值 确定 自 定义 权限 的 使 用 方式 。 在 
PhotoGallery 应 用 中 ， 我 们 使 用 的 protectionLevel 是 signature。 


d 如 果 其 他 应 用 需要 使 用 你 的 自 定 义 权 限 ， 就 

须 使 用 和 当前 应 用 相同 的 key 做 签名 认证 。 对 于 仅 限 应 用 内 部 使 用 的 
A 选择 signature 安 全 级 别 比 较 合 适 。 既 然 其 他 开发 者 没有 相同 的 
key， 自 然 也 就 无 法 接触 到 权限 保护 的 东西 。 此 外 ， 有 了 自己 的 key， 将 
来 还 可 用 于 你 开发 的 其 他 应 用 中 。 


protectionLeve1 还 有 其 他 几 个 可 选 值 ， 表 28-1 汇 总 如 下 。 


表 28-1 protectionLevel 的 可 选 值 


用 于 阻止 应 用 执行 危险 操作 ， 比 如 访问 个 人 隐私 数据 、 地 图 定位 

。 应 用 安装 前 ， 用 户 可 看 到 相应 的 安全 级 别 ， 但 用 户 不 会 被 明 
要 求 给 予 授权 。android.permission.INTERNET 使 用 该 安全 级 别 。 
同样 ， 应 用 让 手机 振动 时 ， 也 使 用 该 安全 级 别 


需要 在 运行 时 调用 requestPermission(.. 函数 明确 要 求 用 户 授 权 


用 于 normal 安 全 级 别 控制 以 外 的 任何 危险 操作 ， 比 如 访问 个 人 隐 
私 数据 、 使 用 可 监视 用 户 的 硬件 功能 等 。 总 之 ， 包 括 一 切 可 能 会 
dangerous 给 用 户 带 来 麻烦 的 行为 。 相 机 使 用 权限 、 位 置 权 限 以 及 联系 人 信 
恩 使 用 权限 都 属于 危险 操作 。 人 dangerous 权 限 


如 果 应 用 签署 了 与 声明 应 用 一 致 的 权限 证 书 ， 则 该 权限 由 系统 授 
Ce Al, 系统 会 拒绝 授权 。 权限 授予 时 ， 系 统 不 会 通知 用 户 。 
signature 它 通 常 适用 于 应 用 内 部 。 只 要 拥有 证 书 ， 则 只 有 签署 了 Re 
的 应 用 才能 拥有 该 权限 ， 因此 开发 者 可 自由 控制 权限 的 使 用 。 
例 中 ， 它 用 来 阻止 其 他 应 用 监听 PhotoGallery 应 用 发 出 的 
broadcast。 不 过 ， 如 有 需要 ， 可 开发 能 够 监听 它们 的 其 他 应 用 


类 似 signature 授 权 级 别 。 但 该 授权 级 别针 对 Android 系 统 镜像 中 的 
signatureOrsystem | 所 有 包 授 权 。 该 授权 级 别 用 于 系统 镜像 内 应 用 间 的 通信 。 权 限 授 


予 时 ， 系 统 不 会 通知 用 户 。 开 发 人 员 一 般 不 会 用 到 它 


28.2.4 创建 并 登记 动态 receiver 


接 下 来 ， 你 需要 一 个 receiver 接 收 ACTION_SHOW_NOTIFICATION 
broadcast intent。 这 个 receiver 的 任务 是 在 用 户 正 在 使 用 应 用 时 ， 阻 止 发 
送 通知 消息 。 


这 个 receiver 只 应 该 在 你 a Tl 前 人 台 时 才 登 记 声 明 。 在 配置 文件 

中 声明 的 standalone receiver 总 在 接收 intent， 其 生命 周期 和 应 用 一 致 ， 所 

首 PhotoGalleryFragment 的 运行 状态 〈 动 态 receiver 不 
么 用 的 ) 。 


使 用 动态 broadcast receiver 能 解决 问题 。 动 态 broadcast receiver 是 在 代码 
中 而 不 是 在 配置 文件 中 完成 登 FRE BH II. 要 在 代码 中 登记 ， 可 调 

用 Context.registerReceiver(BroadcastReceiver， 
IntentFilter) 函 数 ， 要 取消 登记 ， 则 调 
Facontext.unregisterReceiver(BroadcastReceiver) xX. 
receiver 自 身 通常 被 定义 为 一 个 内 部 类 或 一 个 lambda， 如 同一 个 按钮 点 击 
监听 器 。 然 而 ， 在 registerReceiver(... ) 和 
unregisterReceiver(...) 函 数 中 ， 你 :要 的 是 同一 上 实例 ， 因 此 需要 
将 receiver 赋 值 给 一 个 实例 变量 。 


新 建 一 个 VisibleFragment 抽 象 类 ， nn 类 ， 如 代码 清单 28- 
8 所 示 。 该 类 是 一 个 隐藏 前 台 通知 的 通 重用 型 fragment。 (在 第 29 章 ， 你 还 
会 编写 男 一 个 这 样 的 fragment。) 


代码 清单 28-8 ”VisibleFragment 自 己 的 
receiver (VisibleFragment.kt) 


abstract class VisibleFragment : Fragment() { 


private val onShowNotification = object : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent) ( 
Toast.makeText(requireContext(), 
"Got a broadcast: ${intent.action}", 
Toast.LENGTH LONG) 
.Show() 


} 


override fun onStart() ( 
super.onStart() 
val filter - IntentFilter(PollWorker.ACTION SHOW NOTIFICATION) 
requireActivity().registerReceiver( 
onShowNotification, 
filter, 
PollWorker.PERM PRIVATE, 
null 


} 


override fun onStop() ( 
super .onStop() 
requireActivity().unregisterReceiver(onShowNotification) 


注意 ， 要 传 入 一 个 IntentFilter， 必 须 先 以 代码 的 方式 创建 它 。 这 里 
创建 的 IntentFilter 同 以 下 XML 文件 定义 的 filtter 是 一 样 的 : 


<intent-filter> 
«action android: name= 


"com.bignerdranch.android.photogallery.SHOW NOTIFICATION" /> 
«/intent-filter» 


任何 使 用 XML 定义 的 IntentFilter 均 能 以 代码 的 方式 定义 。 要 在 代码 
中 配置 IntentFilter， 可 以 直接 调 

HiaddCategory(String). addAction(String)^l 
addDatapPath(String) 等 函数 。 


使 用 动态 登记 的 broadcast receiver 时 ， 要 记得 事后 清理 。 通 党 ， 如 果 在 
生命 周期 启动 函数 中 登记 了 一 个 receiver， 就 应 在 相应 的 停止 函数 中 调 


用 Context . MC QM M E 

E, 4 fEonStart()rPA Zi Sid, fEonStop() KA ERAEN. "d 
pu a es . ) eA MR 就 应 在 onDestroy() 函 数 里 撤 
niu 

(顺便 要 说 的 是 ， 我 们 应 注意 在 保留 fragment 中 的 onCreate(...) 和 
onDestroy() 函 数 的 使 用 。 设 备 旋 转 时 ，onCreate(...) 和 
onDestroy( ) 函 数 中 的 getActivity() 函 数 会 返回 不 同 的 值 。 因此 ， 如 
果 想 在 Fragment .onCreate(...) 和 Fragment.onDestroy() 函 数 中 实 


现 登 记 或 撤销 登记 ， 应 改 
用 requireActivity() .getApplicationContext() 函 数 。) 


接 下 来 ， 修 改 PhotoGalleryFragment 类 ， 转 而 继承 新 的 
VisibleFragment， 如 代码 清单 28-9 所 示 。 


代码 清单 28-9 ”设置 fragment 为 可 见 CPhotoGalleryFragment.kt ) 


class PhotoGalleryFragment : 


一 VisibleFragment() { 


运行 PhotoGallery 应 用 。 多 次 开关 后 台 结 果 检 查 服务 ， 可 看 到 toast 提 示 


消息 ， 如 图 28-2 所 示 。 


9:00 Pad 


PhotoGallery | — STOP POLLING 


Got a broadcast: com.bignerdranch.android 
.photogallery.SHOW. NOTIFICATION 


28-2 ”验证 收 到 了 broadcast 


28.2.5 ”使 用 有 序 broadcast 收 发 数据 


最 后 ， 你 的 任务 是 保证 动态 登记 的 receiver 总 是 先 于 其 他 receiver 接 收 
fUPollWorker.ACTION SHOW NOTIFICATION broadcast。 然 后 ， 还 要 
修改 这 个 broadcast， 阻 止 通 知 消 息 的 发 布 。 


现在 ， 虽 然 可 以 发 送 个 人 私有 的 broadcast 了 ， 但 目前 还 只 是 发 而 不 收 的 
单 向 通信 ， 如 图 28-3 所 示 。 


PollWorker 


= 
1 1 


| onReceive(Context,Intent) | onReceive(Context, Intent) 


<------ 


28-3 +i broadcast intent 


这 是 因为 ， 普 通 broadcast intent 只 是 概念 上 同时 被 所 有 人 接收 。 而 事实 
上 ，onReceive(...) 函 数 是 在 主线 程 上 调用 的 ， 所 以 各 个 receiver 并 没 
有 同步 并 发 运行 。 因 而 ， 不 可 能 指望 它们 按照 某 种 顺序 依次 运行 ， 也 不 
知道 它们 什么 时 候 全 部 结束 运行 。 结 果 就 是 ， 无 论 是 broadcast receiver 
之 间 要 通信 ， 还 是 intent 发 送 者 要 从 receiver 接 收 反馈 信息 ， 处 理 起 来 都 
很 困难 。 


不 过 ， 我 们 可 以 使 用 有 序 broadcast intent 来 实现 可 预测 的 有 序 通 信 ， 如 
图 28-4 所 示 。 有 序 broadcast 人 允许 多 个 broadcast receiver 依 序 处 理 broadcast 
intent. 


PollWorker 


| 


| onReceive(Context, Intent) 


1 
1 onReceive(Context, Intent) 


<--------------- 


图 28-4 有 序 broadcast intent 


从 接收 方 来 看 ， 这 看 上 去 与 一 般 broadcast 没 什么 不 同 。 然 而 ， 我 们 因此 
获得 了 特别 的 工具 : 一 套 改 变 传递 中 的 intent 的 函数 。 这 里 ， 我 们 需要 

取消 通知 。 这 很 简单 ， 使 用 一 个 简单 的 整 型 结果 人 码 ( 设 置 resultCode 

的 属性 值 为 Activity.RESULT_CANCELED) ， 将 此 要 求 告 诉 通知 发 送 者 
就 可 以 了 。 


修改 VisibleFragment 类 ， 人 告诉 SHOWN_NOTIFICATION 的 发 送 者 应 该 如 
何 处 置 通知 消息 ， 如 代码 清单 28-10 所 示 。 这 个 信息 也 会 发 送 给 接收 链 
中 的 所 有 broadcast receiver。 


代码 清单 28-10 ”返回 一 个 简单 结果 人 码 (VisibleFragment.kt) 


private const val TAG = "VisibleFragment" 


abstract class VisibleFragment : Fragment() { 


private val onShowNotification = object : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent) ( 


// If we receive this, we're visible, so cancel 
// the notification 

Log.i(TAG, "canceling notification") 

resultCode - Activity.RESULT CANCELED 


我 们 只 需要 YES 或 NO 指示 ， 因 此 使 用 Int 结 果 码 就 行 。 如 需 传递 更 多 复 
RAE, Wit BresultDatask il H setResultExtras (Bundle?) rk 

BX Hs BOL PT -TAAA ABR A setResult(Int, String?, 
dE 函数 。 设 定 返 回 值 后 ， 每 个 后 续 接 收 者 均 可 看 到 或 修改 它 

门 


为 了 让 以 上 函数 发 挥 作用 ，broadcast 必 须 有 序 。 在 PollWorker 类 中 ， 


编写 一 个 可 发 送 有 序 broadcast 的 新 函数 ， 如 代码 清单 28-11 所 示 。 该 函数 
打包 一 个 Notification 调 用 ， 然 后 以 一 个 broadcast 发 出 。 在 doWork() 
函数 中 ， 删 除 原 来 直接 发 布 通知 给 NotificationManager 的 代码 ， 调 

用 这 个 新 函数 发 出 一 个 有 序 broadcast。 


代码 清单 28-11 发 送 有 序 broadcast (PollWorker.kt) 


class PollWorker(val context: Context, workerParams: WorkerParameters) : 
Worker(context, workerParams) { 


override fun doWork(): Result { 
val resultId = items.first().id 
if (resultId == lastResultId) ( 
Log.i(TAG, "Got an old result: $resultId") 
) else { 


val notification = NotificationCompat 
.Builder(context, NOTIFICATION CHANNEL ID) 


-build() 


showBackgroundNotification(0, notification) 


} 


return Result.success() 


} 


private fun showBackgroundNotification( 
requestCode: Int, 
notification: Notification 


{ 


val intent = Intent(ACTION SHOW NOTIFICATION).apply { 
putExtra(REQUEST CODE, requestCode) 
putExtra(NOTIFICATION, notification) 

} 


context.sendOrderedBroadcast(intent, PERM_PRIVATE) 
} 


companion object { 
const val ACTION SHOW NOTIFICATION = 
"com.bignerdranch.android.photogallery.SHOW NOTIFICATION" 
const val PERM PRIVATE - "com.bignerdranch.android.photogallery.PRI 
const val REQUEST CODE - "REQUEST CODE" 
const val NOTIFICATION - "NOTIFICATION" 


Context.sendOrderedBroadcast(Intent, String?) KAH HK Al 
sendBroadcast(. . .) 差 不 多 ， 但 它 能 保证 你 的 broadcast 一 次 一 个 地 投 
递 给 各 个 receiver。 有 序 broadcast 发 送出 去 后 ， 结 果 码 会 被 设置 

为 Activity.RESULT_OK。 


更 新 NotificationReceiver 类 ， 发 布 通知 给 目标 用 户 ， 如 代码 清单 
28-12 所 示 。 


代码 清单 28-12 ”实现 result receiver (NotificationReceiver.kt) 


private const val TAG = "NotificationReceiver" 


class NotificationReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Log.i(TAG, "received 


—breadeast: $f{i action} 
— result: $resultCode") 
if (resultCode != Activity.RESULT_OK) { 
// A foreground activity canceled the broadcast 
return 


} 


val requestCode = intent.getIntExtra(PollWorker.REQUEST CODE, 0) 
val notification: Notification - 


intent.getParcelableExtra(PollWorker.NOTIFICATION) 


val notificationManager = NotificationManagerCompat.from(context ) 
notificationManager.notify(requestCode, notification) 


} 


} 


为 保证 NotificationReceiver 在 动态 登记 receiver 之 后 接收 目标 
broadcast 这样， 它 就 知道 该 不 该 向 NotificationManager 发 出 通 
知 ) ， 需 要 为 它 设 置 一 个 低 优 先 级 。 要 让 它 最 后 一 个 运行 ， 设 置 其 优先 
级 值 为 -999， 这 是 用 户 能 定义 的 最 低 优先 级 〈-1000 及 以 下 值 是 系统 保留 
值 ) ， 如 代码 清单 28-13 所 示 。 


代码 清单 28-13 ”修改 notification receiver 的 优先 级 


(manifests/AndroidManifest.xml ) 


«receiver ... > 
<intent-filter android: priority="-999"> 
<action 


android:name="com.bignerdranch. android. photogallery.SHOW_NOTIFI 
</intent-filter> 
</receiver> 


运行 PhotoGallery 应 用 ， 多 次 切换 后 台 轮 询 状 态 。 可 以 看 到 ， 应 用 开 看 
的 时 候 ， 通 知 信息 不 会 出 现 了 。 


28.3 ”receiver 与 长 时 运行 任务 


如 不 愿 受制 于 主线 程 ， 希 望 用 broadcast intent 触 发 一 个 长 时 运行 任务 ， 
该 怎么 做 呢 ? 


有 了 两 种 选择 。 第 一 种 选择 是 将 任务 交 给 服务 去 处 理 ， 然 后 通过 broadcast 
receiver 瞬 时 局 动 服务 。 这 是 我 们 首 推 的 方式 。 服 务 可 以 一 直 运 行 ， 直 

到 完成 要 处 理 的 任务 。 服 务 还 能 将 请 求 放 在 队列 中 ， 然 后 依次 处 理 ， 或 
按 其 上 自 认 为 合适 的 方式 管理 全 部 请 求 。 服 务 虽 然 有 相对 较 长 的 时 间 窗 口 
来 执行 任务 ， 但 运行 时 间 过 长 仍 可 能 会 家 终止 。《〈 这 个 时 间 国 值 到 确 是 
多 少 ， 不 同 的 系统 和 设备 都 不 一 样 ， 但 即便 是 较 新 的 主流 设备 ， 大 概 也 
就 几 分 钟 的 样子 。) 当然 ， 你 可 以 破除 时 间 限 制 ， 直 接 在 前 台 运 行 服 

务 。 对 于 备份 照 睫 、 播 放 音乐 ， 或 者 逐 问 导航 这 样 的 耗 时 任务 来 说 ， 这 
征 最 合适 的 选择 。 


第 二 种 选择 是 使 用 BroadcastReceiver.goAsync() 函 数 。 该 函数 返回 
一 个 BroadcastReceiver.PendingResult 对 象 ， 随 后 可 使 用 该 对 象 提 
供 结 果 。 因 此 ， 可 将 PendingResult 交 给 一 个 AsyncTask 去 执行 长 时 任 
务 ， 然 后 再 调用 PendingResult 的 函数 响应 broadcast。 


goAsync() 函 数 的 浆 端 是 不 够 灵活 。 我 们 仍 需 快速 响应 broadcast (10%) 
内 ) ， 并 且 与 使 用 服务 相 比 ， 没 多 少 架 构 模 式 可 供 选择 了 。 当 

然 ，goAsync() 函 数 也 有 个 明显 的 优势 可 调用 该 函数 设置 有 序 
broadcast 的 结果 。 如 果 别 无 选择 ， 必 须 使 用 ， 应 确保 尽快 结束 。 


28.4 深入 学 习 : 本 地 事件 


broadcast intent 可 实现 系统 内 全 局 性 的 消息 广播 。 如 果 仅 需要 应 用 进程 
内 的 消息 事件 广播 ， 该 怎么 做 呢 ? 答案 是 使 用 事件 总 线 (event bus) 。 


事件 总 线 的 设计 思路 是 ， 提 供 一 个 共享 总 线 或 数据 流 供应 用 内 的 组 件 订 
ee 到 总 线 上 ， 各 订阅 组 件 就 会 被 激活 并 执行 相应 的 回调 


greenrobot 出 品 的 EventBus 是 一 个 第 三 方 事 件 总 线 库 ， 我 们 已 在 目 己 开 
发 的 一 些 应 用 里 用 过 。 你 也 可 以 使 用 其 他 一 些 事件 总 线 ， 比 如 Square 的 
Otto， 或 者 RxJava Subject #lObservable. 


为 实现 在 应 用 内 发 送 broadcast intent，Android 自 己 也 提供 了 一 个 名 
为 LocalBroadcastManager 的 广播 管理 类 。 不 过 ， 两 相 比 较 ， 还 是 上 
述 第 三 方 类 库 用 起 来 更 为 灵活 和 方便 。 


28.4.1 使 用 EventBus 


要 在 应 用 中 使 用 EventBus， 首 先 需 要 在 项 目 中 添加 依赖 库 。 然 后 ， 就 可 
以 定义 事件 类 了 《如 果 需 要 传送 数据 ， 可 以 同事 件 里 添加 数据 字段 ) : 


class NewFriendAddedEvent(val friendName: String) 


在 应 用 的 任何 地 方 ， 都 可 以 把 消息 事件 发 布 到 总 线 上 : 


val eventBus: EventBus = EventBus.getDefault() 


eventBus.post(NewFriendAddedEvent("Susie Q")) 


在 总 线 上 登记 监听 ， 应 用 的 其 他 部 分 也 可 以 订阅 接收 事件 消 轧 。 通 第 ， 
activity 或 fragment 的 登记 和 撤销 登记 都 是 在 相应 的 生命 周期 函数 中 处 理 
的 ， 比 如 onSstart(...) 和 onSstop(...) 函 数 。 


// In some fragment or activity... 
private lateinit var eventBus: EventBus 


public override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
eventBus - EventBus.getDefault() 


} 


public override fun onStart() ( 
super.onStart() 
eventBus.register(this) 


} 


public override fun onStop() { 
super .onStop() 
eventBus.unregister(this) 


AV ASAE ACTH, FY Siti“ ERAS FRA a SP SS 
加 @Subscribe 注 解 ， 让 订阅 者 做 出 响应 。 如 果 使 用 不 带 参数 的 
@Subscribe 注 解 ， 事 件 消息 来 自 哪 个 线程 ， 就 在 哪个 线程 上 处 理 。 如 果 
使 用 @Subscribe(threadMode = ThreadMode.MAIN)， 可 确保 事件 在 主线 
程 上 处 理 ， 哪 怕 它 碰巧 来 自 后 台 线 程 。 


// In some registered component, like a fragment or activity... 
@Subscribe(threadMode = ThreadMode.MAIN) 


fun onNewFriendAdded(event: NewFriendAddedEvent) { 
// Update the UI or do something in response to an event... 


} 


28.4.2 ”使 用 RxJava 


RxJava 也 能 用 来 实现 事件 广播 机 制 。RxJava 库 可 用 来 开发 reactive 风 格 的 
Java 人 代码。 上 述 reactive 概 念 有 深 广 的 含义 ， 不 在 本 书 讨论 之 列 。 简 而 言 
之 ， 有 了 RxJava， 就 可 以 发 布 和 订阅 各 类 事件 ， 并 且 还 有 很 多 通用 工具 


用 来 管理 这 些 事件 。 


比如 ， 你 可 以 创建 一 个 名 为 Subject 的 对 象 ， 然 后 发 布 事件 给 它 以 及 在 
其 上 订阅 事件 。 


val eventBus: Subject<Any, Any> = 
PublishSubject.create<Any>().toSerialized() 


可 以 像 这 样 发 布 事件 给 它 : 


val someNewFriend = "Susie Q" 


val event = NewFriendAddedEvent (someNewFriend) 
eventBus.onNext(event) 


并 且 在 其 上 订阅 事件 : 


eventBus.subscribe { event: Any -> 
if (event is NewFriendAddedEvent) ( 
val friendName = event.friendName 


// Update the UI 


RxJava 解 决 方案 的 优势 在 于 ，eventBus 现 在 也 是 个 Observable 对 象 
(代表 RxJava 的 事件 流 ) 了 。 这 意味 着 RxJava 的 各 种 事件 管理 工具 都 可 
以 为 你 所 用 。 是 不 是 你 发 感 兴趣 了 ? 去 看 看 RxJava 项 目的 wiki 主页 吧 。 


28.5 ”深入 学 习 : 受 限 的 Broadcast Receiver 


本 章 开 头 讲 过 ， 在 Android manifest 文 件 里 声明 的 broadcast receiver 可 能 
不 会 啊 应 消息 通知 。 另 外 ， 应 用 运行 在 Android Oreo 或 更 高 版 本 系统 的 
设备 上 也 会 有 此 情况 。 而 使 用 registerReceiver(...) 动 态 登 记 的 
receiver 就 不 会 有 此 问题 。 


实际 上 ，Android 限 制 broadcast receiver 的 行为 方式 主要 是 为 了 省 电 和 提 
升 用 户 设备 的 性 能 表现 。 假 设 你 已 在 manifest 文 件 里 声明 一 个 broadcast 
receiver， 你 的 应 用 也 还 没 运行 ， 这 时 ， 只 要 有 广播 发 给 你 的 receiver， 
系统 就 必须 启动 一 个 处 理 进程 。 只 是 一 两 个 应 用 有 此 情况 还 好 ， 如 果 很 
多 应 用 都 需要 接收 消息 ， 那 么 系统 肯 定 会 被 拖 慢 。 


证 明 此 举 会 严重 影响 用 户 体验 的 一 个 例子 是 ， 用 尸 有 很 多 应 用 都 来 主动 
备份 相机 最 新 拍照 ， 只 要 用 户 一 按 相 机 快门 ， 系 统 就 局 动 多 个 后 台 进 程 
准备 备份 。 显 然 ， 用 户 因 此 会 党 得 相机 应 用 反应 迟钝 。 


为 消除 这 种 性 能 问题 ， 自 Android Oreo 开 始 ， 新 版 Android 系 统 不 再 发 送 
隐 式 广播 给 manifest 文 件 里 声明 的 broadcast receiver, 〈 不 过 ， 显 式 广 播 
不 受 此 限制 ， 但 你 知道 ， 这 类 广播 用 得 少 ， 且 只 能 发 送 给 一 个 


receiver. ) 


一 些 系 统 内 部 广播 不 受 此 限制 。 登 记 在 manifest 里 用 于 
BOOT_COMPLETE、TIMEZONE_CHANGED 和 NEW_OUTGOITNG_CALL 的 
broadcast receiver 还 是 能 收 到 和 它们 各 上 自 预期 的 广播 。 此 类 广播 一 般 很 少 
发 ， 并 且 Android 也 没有 更 好 的 通知 发 送 解决 方案 ， 所 以 它们 不 受 限 
制 。 访 问 开 发 者 文档 页 可 以 看 到 所 有 不 受 限 的 系统 广播 清单 。 


另外 ， 本 章 学 习 过 程 中 你 也 看 到 了 ， 以 signature-level 权 限 发 送 的 广播 是 
不 受 限 的 。 这 样 一 来 ， 你 可 以 继续 使 用 应 用 私有 的 standalone broadcast 

receiver。 当 然 ， 这 同样 适用 于 你 开发 的 使 用 同样 权限 的 应 用 。 因 为 只 

有 同一 开发 者 开发 的 应 用 能 发 送 有 同样 权限 的 广播 ， 显 然 ， 这 类 广播 不 
会 给 系统 里 的 其 他 应 用 带 来 性 能 问题 。 


28.6 ”深入 学 习 : 探测 fragment 的 状态 


本 章 ， 在 实现 PhotoGallery 应 用 的 通知 功能 时 ， 我 们 使 用 了 全 局 性 的 
broadcast 机 制 。broadcast 虽 然 是 全 局 的 ， 但 利用 定制 权限 ， 我 们 实现 限 
xe broadcast intent 只 能 在 应 用 内 接收 。 这 就 不 免 让 人 疑惑 :“ 既 然 要 限 
制 ， 为 什么 还 要 使 用 全 局 机 制 ? 使 用 本 地 broadcast 机 制 不 是 更 好 吗 ? » 


这 是 因为 有 个 难题 要 解决 ， 如 何 判 断 PhotoGalleryFragment 的 活动 状 
态 。 最 终 ， 利 用 有 序 broadcast、standalone receiver 以 及 动态 登记 的 
receiver， 问 题 总 算 解 决 了 。 虽 然 没 那么 干净 利沙 ， 但 这 是 Android 目 前 
能 提供 的 最 好 解决 方案 。 


总 而 言 之 ， 不 用 本 地 broadcast 机 制 ， 就 是 因 
为 LocalBroadcastManager 既 无 法 处 理 PhotoGallery 应 用 里 的 这 种 
broadcast 通 知 ， 也 无 法 知晓 fragment 的 状态 。 如 果 继 续 深 究 ， 原 因 不 外 


首先 ，LocalBroadcastManager 不 支持 有 序 broadcast (虽然 它 有 
个 sendBroadcastSync(Intent) 函 数 ， 但 依然 不 行 )， 而 在 
PhotoGallery 应 用 中 ， 不 使 用 有 序 broadcast， 就 无 法 控 


yo 


制 NotificationReceiver 最 后 一 个 运行 。 


其 次 ，sendBroadcastSync(Intent) 函 数 不 支 持 在 独立 线程 上 发 送 和 
接收 broadcast。 而 在 PhotoGallery 应 用 中 ， 需 要 在 后 台 线 程 上 发 送 
broadcast (使 用 PollWorker .dowork() KZO ， 在 主线 程 上 接收 
intent (在 主线 程 上 的 onStart(... ) 函 数 中 使 

用 PhotoGalleryFragment 登 记 的 动态 receiver) 。 


本 书 撰写 时 ， 关 于 LocalBroadcastManager 究 竟 是 如 何 处 理 线 程 上 的 
broadcast 投 递 的 ，Android 还 没有 确切 的 说 明 。 但 经 验 告诉 我 们 ， 它 是 有 
规律 可 循 的 。 例 如 ， 如 果 从 后 台 线 程 调用 sendBroadcastSync(...)， 
所 有 的 pending broadcast 都 会 在 后 台 线 程 上 涌 出 ， 不 管 是 不 是 来 自主 线 


程 。 


当然 ，LocalBroadcastManager 也 不 是 一 无 是 处 ， 只 不 过 不 适合 解决 
本 章 的 问题 而 已 。 


第 29 章 网 页 浏览 


从 Flickr 下 载 的 图 片 都 有 其 关联 网 页 。 本 章 ， 我 们 继续 升级 PhotoGallery 
应 用 ， 让 用 户 点 击 图 片 就 能 看 到 它 的 Flickr 网 页 。 我 们 会 以 两 种 不 同 的 
方式 整合 网 页 内 容 ， 结 果 如 图 29-1 所 示 。 左 边 是 使 用 浏览 器 应 用 碍 看 网 
页 ， 右 边 是 使 用 WebView 在 应 用 中 显示 网 页 。 
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图 29-1 以 两 种 方式 呈现 Web 内 容 


29.1 最 后 一 段 Flickr 数 据 


无 论 采 用 哪 种 方式 ， 都 需要 取得 Flickr 图 片 页 的 URL。 如 果 查 看 下 载 网 
片 的 JSON 文 件 ， 可 看 到 图 片 的 网 页 地 址 并 不 包含 在 内 。 


1 


"photos": ( 


e 
"photo": [ 
{ 
"id": "9452133594", 
"owner": "44494372@N05", 
"secret": "d6d20af93e", 
"server": "7365", 
"farm": 8, 
"title": “Low and Wisoff at Work", 
"ispublic": 1, 
"isfriend": 60, 
"isfamily": 0, 
"url s":"https://farm8.staticflickr.com/7365/9452133594 d6d20af93e 


注意 ，url_s 是 小 尺寸 版 图 片 的 URL (你 需要 的 是 全 尺寸 版 图 片 〉。 


因此 ， 你 想当然 地 认为 需要 获取 更 多 JSON 内 容 才 行 。 实 际 上 ， 并 不 是 
这 样 的 。 查 看 Flickr 官 方 文档 的 Web Page URLs 部 分 可 知 ， 可 按 以 下 格式 
创建 单个 图 片 的 URL: 


http://www.flickr.com/photos/user-id/photo-id 


这 里 的 photo-id 即 JSON 数 据 里 的 id 属性 值 。 该 值 已 保存 

在 GalleryItem 类 的 id 属性 中 。 那 么 user-id 呢 ? 继续 查阅 Flickr 文 档 
可 知 ，JSON 文 件 的 owner 属 性 值 就 是 用 户 ID。 因 此 ， 只 需 从 JSON 文 件 
解析 出 owner 属 性 值 ， 即 可 创建 图 片 的 完整 URL: 


http://www.flickr.com/photos/owner/id 


在 GalleryItem 中 添加 代码 清单 29-1 所 示 代 码 ， 创 建 图 片 URL。 
代码 清单 29-1 添加 创建 图 片 URL 的 代码 (GalleryItem.kt) 


data class GalleryItem( 
var title: String = "", 
var id: String = "", 
@SerializedName("url_s") var url: String = "", 
@SerializedName("owner") var owner: String = "" 


yx 
val photoPageUri: Uri 


get() 4 
return Uri.parse("https://www.flickr.com/photos/") 
.buildUpon() 
.appendPath(owner) 
.appendPath(id) 
.build() 


以 上 代码 新 建 了 一 个 owner 属 性 ， 以 及 一 个 生成 图 片 URL 的 
photoPageUri 计 算 属 性 。Gson 已 经 帮 你 把 JSON 数 据 解析 

到 GalleryItem 中 ， 无 须 额外 编码 就 可 以 直接 使 用 photoPageUri 属 性 
Ta 


29.2 ”简单 方式 : 1H intent 


使 用 隐 式 intent 这 个 老 朋 友 来 访问 图 片 URL。 隐 式 intent 可 启动 浏览 器 ， 
并 在 其 中 打开 图 片 URL 指 辣 的 网 页 。 


首先 ， 监 听 RecyclerView 显 示 项 的 点 击 事件 。 更 新 
PhotoGalleryFragment 类 的 PhotoHolder， 实 现 一 个 可 以 发 送 隐 式 
intent 的 事件 监听 函数 ， 如 代码 清单 29-2 所 示 。 


代码 清单 29-2 ”通过 隐 式 intent 实 现 网 页 浏览 
(PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : VisibleFragment() { 


private inner class PhotoHolder(private val itemImageView: ImageView) 
: RecyclerView. ViewHolder(itemImageView) , 


View.OnClickListener { 


private lateinit var galleryItem: GalleryItem 


init { 
itemView. setOnClickListener (this) 


} 


val bindDrawable: (Drawable) -> Unit = itemImageView: :setImageDrawa 


fun bindGalleryItem(item: GalleryItem) { 
galleryItem = item 
} 


override fun onClick(view: View) { 


val intent = Intent(Intent.ACTION_VIEW, galleryItem.photoPageUr 
startActivity(intent) 


给 PhotoHolder 类 添加 inner 关 键 字 能 让 你 访问 外 部 类 的 属性 和 函数 。 
这 里 的 应 用 就 是 从 PhotoHolder 里 调 
用 Fragment.startActivity(Intent)。 


然后 ， 在 PhotoAdapter.onBindViewHolder(...) 函 数 中 绑 定 
PhotoHolder 给 GalleryItem， 如 代码 清单 29-3 所 示 。 


代码 清单 29-3” 绑 定 GalleryItem (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : VisibleFragment() { 


private inner class PhotoAdapter(private val galleryItems: List>Gallery| 
RecyclerView.Adapter<PhotoHolder>() { 


override fun onBindViewHolder(holder: PhotoHolder, position: Int) { 
val galleryItem = galleryItems[position] 
holder.bindGalleryItem(galleryItem) 
val placeholder: Drawable = ContextCompat.getDrawable( 
requireContext(), 
R.drawable.bill up close 
) ?: ColorDrawable() 
holder.bindDrawable(placeholder) 
thumbnailDownloader.queueThumbnail(holder, galleryItem.ur1) 


} 


搞定 了。 局 动 PhotoGallery 应 用 并 点 击 任意 图 片 。 浏 览 占 应 用 应 该 会 弹 
出 并 加 载 显 示 对 应 的 图 片 网 页 (类 似 图 29-1 的 左边 )〉。 


29.3 ” 较 难 的 方式 : 使 用 WebView 


使 用 隐 式 intent 打 开 图 片 网 页 既 简 单 又 高 效 。 但 是 ， 如 果 不 想 打开 独立 
的 浏览 器 怎么 办 ? 


通常 ， 我 们 只 想 在 activity 中 显示 网 页 内 容 ， 而 不 是 打开 浏览 器 。 这 么 做 
或 许 是 想 显 示 自 己 生成 的 HIML， 或 许 是 想 以 某 种 方式 限制 用 户 使 用 浏 
咏 费 。 对 于 大 多 数 需 要 帮助 文档 的 应 用 ， 常 见 的 做 法 就 是 以 网 页 的 形式 
提供 帮助 文档 ， 这 样 会 方便 后 期 的 更 新 与 维护 。 打 开 浏 览 絮 查看 帮助 文 
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如 果 想 在 应 用 里 显示 网 页 内 容 ， 你 可 以 使 用 WebView 类 。 这 就 是 我 们 说 
的 较 难 的 方式 ， 但 实际 也 没 那 么 难 。 (当然 ， 相 对 隐 式 intent 来 说 ， 要 
困难 一 些 。) 


首先 ， 创 建 一 个 activity 以 及 一 个 显示 WebView 的 fragment。 依 惯例 先 定 
义 一 个 名 为 res/layout/fragment_photo_page.xml 的 布局 文件 。 使 用 一 

个 ConstraintLayout 作 为 一 级 部 件 。 在 布局 编辑 窗口 ， 安 排 一 

个 WebView 作 为 ConstraintLayout 的 子 部 件 。 (WebView 位 于 
Containers 区 的 下 面 。) 


添加 完 NebView， 相 对 其 父 部 件 ， 为 每 一 边 添加 一 个 约束 。 有 具体 如 下 : 
e 从 WebView 顶 部 到 其 父 部 件 顶 部 ; 
e 从 WebView 底 部 到 其 父 部 件 底部 ; 
。 从 WebView 左 边 到 其 父 部 件 左边 ; 
e 从 WebView 右 边 到 其 父 部 件 右边 。 


最 后 ， 高 和 宽 设 置 为 Match Constraint 并 设置 所 有 的 margin 为 0。 另 外 ， 


别 筷 了 给 NebView 一 个 ID: web_view. 


是 不 是 认为 这 里 的 ConstraintLayout 没 什么 用 ?现在 是 这 样 ， 稍 后 会 
添加 更 多 部 件 来 完善 它 。 


接 下 来 创建 fragment。 新 建 PhotoPageFragment 类 ， 继 承 上 一 章 的 
VisibleFragment 类 。 然 后 ， 在 这 个 新 类 中 ， 实 例 化 布局 文件 ， 引 
用 WebView， 并 转发 从 intent 数 据 中 获取 的 URL， 如 代码 清单 29-4 所 示 。 


代码 清单 29-4 创建 网 页 浏览 fragment (PhotoPageFragment.kt ) 


private const val ARG_URI = "photo_page url" 


class PhotoPageFragment : VisibleFragment() { 


private lateinit var uri: Uri 
private lateinit var webView: WebView 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 


uri = arguments?.getParcelable(ARG URI) ?: Uri.EMPTY 
j 


override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view - inflater.inflate(R.layout.fragment photo page, container 


webView - view.findViewById(R.id.web view) 


return view 


} 


companion object { 
fun newInstance(uri: Uri): PhotoPageFragment { 
return PhotoPageFragment().apply { 
arguments = Bundle().apply { 
putParcelable(ARG_URI, uri) 


j 


EM 


当前 ，PhotoPageFragment 类 还 未 完成 ， 稍 后 再 来 完成 它 。 接 下 来 ， 
新 建 PhotoPageActivity 托 管 类 来 托管 PhotoPageFragment， 如 代码 
清单 29-5 所 示 。 


代码 清单 29-5 创建 显示 网 页 的 activity (PhotoPageActivity.kt) 


class PhotopageActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity photo page) 


val fm = supportFragmentManager 
val currentFragment - fm.findFragmentById(R.id.fragment container) 


if (currentFragment -- null) ( 
val fragment - PhotoPageFragment.newInstance(intent.data) 
fm.beginTransaction() 
.add(R.id.fragment container, fragment) 
. commit() 


} 


companion object { 
fun newIntent(context: Context, photoPageUri: Uri): Intent { 
return Intent(context, PhotoPageActivity::class.java).apply { 
data = photoPageUri 


创建 PhotopageActivity 对 应 的 res/layout/activity_photo_page.xml 布 局 
文件 ， 定 义 一 个 FrameLayout 部 件 ， 设 置 其 I 人 DD 为 fragment_container， 如 
代码 清单 29-6 所 示 。 


代码 清单 29-6 ”添加 activity 布 局 
(res/layout/activity_photo_page.xml ) 


<?xml version-"1.0" encoding-"utf-8"?» 
«FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android: id="@+id/fragment_container" 

android: layout_width="match_parent" 

android: layout_height="match_parent"/> 


回 到 PhotoGalleryFragment 类 中 ， 弃 用 隐 式 intent， 启 动 新 建 的 
activity， 如 代码 清单 29-7 所 示 


代码 清单 29-7 启动 新 建 的 activity (PhotoGalleryFragment.kt) 


class PhotoGalleryFragment : VisibleFragment() { 


private inner class PhotoHolder(private val itemImageView: ImageView) 
: RecyclerView. ViewHolder(itemImageView) , 
View.OnClickListener { 


override fun onClick(view: View) { 


val intent = PhotoPageActivity 
-newIntent(requireContext(), galleryItem. photoPageUri ) 
startActivity (intent) 


最 后 ， 在 配置 文件 中 声明 新 建 的 activity， 如 代码 清单 29-8 所 示 。 
代码 清单 29-8 在 配置 文件 中 声明 


activity (manifests/AndroidManifest.xml ) 


<manifest ... > 


<application 
bp mae 
«activity android:name=".PhotoGalleryActivity"> 


</activity> 

<activity android:name=".PhotoPageActivity"/> 

«receiver android:name=".NotificationReceiver" 
e» 


</receiver> 
</application> 


</manifest> 


运行 PhotoGallery 应 用 ， 点 击 任意 图 片 ， 可 看 到 一 个 新 的 空 activity 弹 
Hs 


好 了 ， 现 在 来 处 理 关 键 部 分 ， 让 fragment 发 挥 其 作用 。WebView 要 显示 
Flickr 图 片 网 页 ， 需 做 三 件 事 。 


首先 是 告诉 WebView 要 打开 的 URL。 


其 次 是 启用 JavaScript。JavaScript 默 认 是 禁用 的 。 虽 然 并 不 总 是 需要 启 
用 它 ， 但 Flickr 网 站 需要 。 [局 用 JavaScript 后 ，Android Lint 会 提示 警告 
信息 (担心 跨 网 站 的 脚本 攻击 ) ， 可 以 使 用 
@SuppressLint("SetJavaScriptEnabled") 注 解 onCreateView(... ) 函 数 以 
禁止 Lint 的 警告 。] 


最 后 ， 需 要 实现 一 个 NebViewClient 类 (用 来 响应 WebView 上 的 演 染 事 
件 ) 。 添 加 代码 清单 29-9 所 示 代 码 。 然 后， 我 们 来 详细 解读 


PhotopageFragment 类 。 


代码 清单 29-9 加 载 URL (PhotoPageFragment.kt) 


class PhotoPageFragment : VisibleFragment() { 


@SuppressLint("SetJavaScriptEnabled" ) 
override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view - inflater.inflate(R.layout.fragment photo page, container 


webView - view.findViewById(R.id.web view) 
webView.settings.javaScriptEnabled - true 
webView.webViewClient - WebViewClient() 
webView.loadUrl(uri.toString()) 


return view 


加 载 URL 必 须 等 WebView 配 置 完成 后 进行 ， 因 此 最 后 再 执行 这 一 操作 。 
在 此 之 前 ， 首 先 访 问 settings 属 性 获得 Nebsettings 实 例 ， 再 设 

置 WebSsettings.javaSscriptEnabled = true 启 用 
JavaScript。WebSsettings 是 修改 MebView 配 置 的 三 种 途径 之 一 。 另 外 还 
有 其 他 一 些 可 设置 属性 ， 如 用 户 代 理 字符 串 和 显示 文字 大 小 。 


然后 ， 给 WebView 添 加 一 个 WebViewClient。 为 什么 要 添加 ? 解释 之 
前 ， 我 们 先 看 看 没有 它 会 发 生 什 么 。 


载 入 一 个 新 URL 有 好 几 种 方式 : 当前 页 面 刷新 让 你 转 入 男 一 个 URL (一 
TEEN) ， 或 者 点 击 一 个 链接 载 入 。 如 果 没 

有 WebViewClient，WebView 会 要 求 activity 管 理 器 找 一 个 新 activity 来 载 
入 新 URL。 


这 不 是 我 们 想 要 的 。 如 宁 从 手机 浏览 右 加 载 ， 许 多 网 址 〈 包 括 Flickr 图 
片 网 页 ) 会 重 定向 到 移动 版 本 的 网 址 。 因 此 ， 发 送 一 个 隐 式 intent 启 动 
其 他 浏览 器 应 用 解决 不 了 问题 。 我 们 需要 在 自己 应 用 里 展示 网 页 。 


给 WebView 添 加 一 个 WebViewClient， 事 情 就 不 一 样 了 。 现 

在 ，WebView 不 会 再 去 麻烦 activity 管 理 嚣 ， 它 会 去 

找 WebViewClient。 按 照 WebViewClient 的 默认 实现 ， 它 会 

Ji: “WebView， 自 己 载 入 URL 吧 。” 这 样 ， 目 标 网 页 就 在 WebView 中 打 
PRIS 


运行 应 用 ， 扣 击 任意 图 片 ， 应 该 可 以 看 到 显示 对 应 图 片 的 WebView (28 
似 图 29-1 的 右边 ) 。 


使 用 WebChromeClient 优 化 WebView 显 示 


既然 花 时 间 实 现 了 目 己 的 WebView， 接 下 来 开始 优化 ， 为 它 添加 网 页 标 
题 和 进度 条 。 这 些 WebView 外 面 的 装饰 和 UI 部 分 有 个 名 字 叫 chrome (不 
要 和 Google 的 Chrome 浏 览 右 搞 混 了 ) o 


以 预览 的 方式 打开 fragment_photo_page.xml， 拖 入 一 个 ProgressBar 部 


件 作 为 ConstraintLayout 的 第 二 个 子 部 件 [使 
用 ProgressBar (Horizontal) 版 本 ) ] 。 删 除 NebView 最 上 面 的 约束 。 
然后 为 方便 使 用 它 的 约束 handle， 设 置 其 高 度 值 为 Fixed。 


完成 后 ， 再 创建 以 下 额外 约束 。 


e 从 ProgressBar 到 其 父 部 件 的 上 、 左 、 碳 。 
e 从 WebView 的 顶部 到 ProgressBar 的 底部 。 


接 下 来 ， 重 置 WNebView 的 高 度 为 Match Constraint， 重 置 ProgressBar 的 
高 度 为 wrap_content、 宽 度 为 Match Constraint. 


最 后 ， 选 中 ProgressBar 部 件 ， 在 右边 的 属性 窗口 ， 将 visibility 和 tools 
visibility 分 别 设置 为 gone 和 visible， 最 后 重 命 名 其 ID 为 progress_bar。 完 
成 后 的 结果 如 图 29-2 所 示 。 
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图 29-2 添加 ProgressBar 


为 使 用 ProgressBar， 还 需 使 用 WebView:WebChromeClient 的 第 二 个 
回调 函数 。 如 果 说 WebViewClient 是 响应 演 染 事件 的 接口 ， 那 

么 WebChromeClient 就 是 一 个 事件 接口 ， 用 来 响应 那些 改变 浏览 器 中 
装饰 元 素 的 事件 。 这 包括 JavaScript 警 告 信息 、 网 页 图 标 、 状 态 条 加 载 ， 
以 及 当前 网 页 标题 的 刷新 。 


在 onCreateView(...) 函 数 中 ， 编 码 实 现 使 用 NebChromeClient， 如 
代码 清单 29-10 所 示 。 


代码 清单 29-10 ”使 用 WebChromeClient (PhotoPageFragment.kt ) 


class PhotoPageFragment : VisibleFragment() { 


private lateinit var uri: Uri 
private lateinit var webView: WebView 
private lateinit var progressBar: ProgressBar 


@SuppressLint("SetJavaScriptEnabled" ) 
override fun onCreateView( 
inflater: LayoutInflater, 
container: ViewGroup?, 
savedInstanceState: Bundle? 
): View? { 
val view - inflater.inflate(R.layout.fragment photo page, container 


progressBar = view.findViewById(R.id.progress bar) 
progressBar.max - 100 


webView - view.findViewById(R.id.web view) 
webView.settings.javaScriptEnabled - true 
webView.webChromeClient = object : WebChromeClient() { 
override fun onProgressChanged(webView: WebView, newProgress: I 
if (newProgress -- 100) ( 
progressBar.visibility - View.GONE 
) else { 
progressBar.visibility = View.VISIBLE 
progressBar.progress = newProgress 


} 


override fun onReceivedTitle(view: WebView?, title: String?) { 
(activity as AppCompatActivity) .supportActionBar?.subtitle 


} 
} 
webView.webViewClient = WebViewClient() 
webView.loadUrl(uri.toString()) 


return view 


进度 条 和 标题 栏 更 新 都 有 各 目的 回调 函数 ， 
EJonProgressChanged(WebView, Int) fil 
onReceivedTitle(WebView, String) razr. JA 
onpProgressChanged(NebVvView，Int) 冰 数 收 到 的 网 页 加 载 进 度 是 一 个 
从 0 到 100 的 整数 值 。 如 果 值 是 100， 说 明 网 页 已 完成 加 载 ， 因 此 需 设 置 
进度 条 可 见 性 为 View.GONE， 将 ProgressBar 视 图 隐藏 起 来 。 


运行 PhotoGallery 应 用 。 现 在 ， 应 看 到 如 图 29-3 所 示 的 应 用 画面 。 
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图 29-3 ”漂亮 的 NebView 


点 击 任意 图 片 ，PhotoPageActivity 会 出 现 。 网 页 加 载 时 ， 会 出 现 进 
度 条 ， 工 具 栏 会 出 现 来 自 onReceivedTit1le(. ..) 函 数 的 子 标题 。 页 面 
加 载 完 毕 ， 进 度 条 随即 消失 。 


29.4 ”处 理 WebView 的 设备 旋转 问题 


莹 试 旋 转 设备 屏幕 。 尽 管 应 用 工作 如 常 ， 但 NebView 重 新 加 载 了 网 页 。 
这 是 因为 NebView 包 含 太 多 数据 ， 无 法 在 onSaveInstanceState(...) 
函数 内 全 部 保存 。 每 次 设备 旋转 ， 它 都 必须 从 头 开 始 加 载 网 页 数据 。 


是 不 是 想到 了 PhotopPageFragment 保 留 ? 不 好 意思 ， 这 里 行 不 通 。 
ZINE ea 的 一 部 分 ， 所 以 旋转 后 它 表 定 会 销 蝶 并 重 
建 。 

对 于 一 些 类 似 的 类 (比如 VideoView) ，Android 文 档 推 荐 让 activity 自 
己 处 理 设 备 配 置 变更 。 也 就 是 说 ， 无 须 销 毁 重 建 activity， 就 能 直接 调整 
ae ee 这 样 ，WebView 也 就 不 必 重 新 加 载 全 
部 数据 了 。 


为 了 让 PhotoPageActivity 自 己 处 理 设备 配 置 调 整 ， 在 
manifests/AndroidManifest.xml 文 件 中 做 如 下 调整 ， 如 代码 清单 29-11 所 
TR 


代码 清单 29-11 自己 处 理 设备 配置 更 改 


(manifests/AndroidManifest.xml ) 


<manifest ... > 


«activity android:name=".PhotoPageActivity” 


android: configChanges="keyboardHidden|orientation|screenSize" /> 


</manifest> 


android:configChanges 属 性 表明 ， 如 有 条 因 键 盘 开 或 和 天、 屏幕 方 同 改 
变 、 屏 幕 大 小 改变 (也 包括 Android 3.2 之 后 的 屏幕 方向 变化 ) 而 发 生 设 
备 配 置 更 改 ， 那 么 activity 应 自己 处 理 配 置 更 改 。 事 实 上 ， 视 图 会 自 适应 
新 屏幕 尺寸 ， 所 以 无 须 额外 做 一 些 事情 来 处 理 设备 的 配置 变化 。 


运行 应 用 ， 再 次 答 试 旋转 设备 ， 一 切 都 完美 了 。 
目 己 处 理 配置 更 改 的 风险 


自己 处 理 设备 配 置 更 改 ， 我 们 轻松 搞定 了 WebView 的 设备 旋转 问题 。 既 
然 这 么 简单 ， 为 什么 不 全 面 推广 使 用 这 个 方法 呢 ? 实际 上 ， 事 情 没 那么 
简单 ， 自 己 处 理 配置 变更 也 是 有 风险 的 。 


首先 ， 资 源 修饰 符 无 法 自动 工作 了 。 如 果 检 测 到 设备 配置 改变 ， 开 发 人 
员 则 必须 手动 重 载 视图 。 这 实际 是 非常 国手 的 。 


其 次 ， 也 是 更 重要 的 一 点 ， 既 然 activity 自 己 处 理 配 置 更 改 了 ， 你 很 可 能 
不 会 去 覆盖 Activity.onSavedInstanceState(...) 函 数 存 储 UI 状 
态 。 然 而 ， 这 依然 是 必需 的 ， 即 使 自己 处 理 设 备 配置 更 改 也 是 一 样 。 因 
为 低 内 存 情 况 还 是 要 考虑 的 。〈 还 记得 吗 ? activity 不 运行 的 时 候 ， 系 统 
可 能 会 销毁 并 暂 存 它 的 状态 ， 比 如 在 图 4-9 中 看 到 的 那样 。) 


29.5 WebView 与 定制 UI 


要 想 完全 控制 应 用 的 外 观 和 行为 表现 就 得 使 用 原生 定制 UI (而 不 
^EWebView) 。 对 用 户 来 说 ， 原 生 定 制 UI 的 应 用 啊 应 更 迅速 ， 风 格 更 统 
一 。 但 使 用 WebView 显 示 网 页 内 容 也 有 其 优势 。 


例如 ， 在 WebView 里 显示 Flickr 网 站 内 容 方便 你 快速 引入 各 种 新 特性 。 

像 图 片 描述 、 用 户 账号 ， 或 者 其 他 要 显示 的 图 片 信 息 等 ，Flickr 网 站 中 
都 有 现成 的 ， 你 不 用 费心 去 抓 取 解 机， 然后 再 设法 展示 ， 直 接 显示 网 页 
内 容 就 可 以 。 


为 外 ， 和 直接 显示 网 页 内 容 还 有 个 优点 :即使 网 页 内 容 随时 在 变 ， 你 的 应 
用 也 无 须 跟着 改变 。 例 如 ， 如 果 应 用 需要 展示 一 些 隐 私 政 全 或 服务 条 
球 ， 你 可 以 选择 不 在 应 用 里 便 编码 展示 文档 ， 直 接 展示 一 个 网 页 。 这 
样 ， 任 何 内 容 更 新 直接 推送 到 网 站 就 可 以 了 ， 应 用 完全 不 用 升级 。 


29.6 深入 学 习 : 注入 JavaScript 对 象 


你 已 经 知道 如 何 使 用 WebViewClient 和 WebChromeClient 类 响应 发 生 


在 NebView 里 的 特定 事件 。 不 过 ， 通 过 注入 任意 JavaScript 对 象 

到 NebView 本 喘 包 含 的 文档 中 ， 你 还 可 以 做 更 多 事 。 打 开 文 档 网 页 ， 找 
$laddJavascriptInterface(Object, String) HAEA. BAHI 
是 Java 方 法 签名 ， 但 0bject 参 数 束 相当 于 Kotlin 里 的 Any。 使 用 该 方 
法 ， 可 注入 任意 JavaScript 对 象 到 指定 文档 中 : 


webView.addJavascriptInterface(object : Any() { 
@JavascriptInterface 
fun send(message: String) { 


Log.i(TAG, "Received message: $message") 


} 
}, "androidObject") 


然后 按 如 下 方式 调用 : 


«input type-"button" value-"In WebView!" 
onClick="sendToAndroid('In Android land')" /> 


<script type="text/javascript"> 


function sendToAndroid(message) { 
androidObject.send(message) ; 


} 


</script> 


上 述 代 码 有 些 地 方 值得 讨论 。 首 先 ， 调 用 send(String) 函 数 时 ， 它 不 
是 在 主线 程 上 ， 而 是 在 WebView 拥 有 的 线程 上 被 调用 的 。 因 此 ， 要 是 有 
Android UI 更 新 任务 ， 你 需要 使 用 Handler 将 控制 传 回 主线 程 。 


其 次 ， 除 了 String， 其 他 好 多 数据 类 型 都 设法 文 持 。 如 果 有 其 他 复杂 
数据 类 型 ， 那 只 能 转 成 String 类 型 ， 比 如 ， 转 成 常见 的 JSON 格 式 。 使 
用 者 收 到 后 ， 目 己 再 去 按 需 解析 。 


HJelly Bean 4.2 (API17) 开始 ， 只 有 以 @JavascriptInterface 注 解 的 公共 
函数 才 会 暴露 给 JavaScrpit。 在 这 之 前 ， 所 有 对 象 树 中 的 公共 函数 都 是 开 
放 访 问 的 。 


这 可 能 有 风险 ， 因 为 一 些 潜在 问题 网 页 能 够 直接 接触 到 应 用 。 安 全 起 
见 ， 要 么 目 己 掌控 局 面 ， 要 么 严 控 不 暴露 目 己 的 接口 。 


29.7 深入 学 习 : WebView 升 级 


基于 Chromium 开 源 项 目 开 发 ，WebView 有 和 Android 版 Chrome 应 用 一 样 
的 演 染 引擎。 它们 的 页 面 外 观 和 浏览 器 行为 也 基本 能 保持 一 致 。 〈 然 
而 ，WebView 并 不 具有 Android Chrome 的 全 部 特性 。) 


WebView 的 Chromium 本 质 表 明 ， 在 Web 标 准 和 JavaScript 上 它 也 一 直 保 
持 最 新 。 从 开发 者 的 角度 看 ， 一 个 最 令 人 兴奋 的 新 特性 就 是 ，WNebView 
终于 支持 使 用 Chrome DevTools 进 行 远程 调试 了 ( 调 

用 WebView.setNebContentsDebuggingEnabled() 函 数 开 局 ) o 


Lollipop (Android 5.0) 开始 ，WebView 的 Chromium 层 会 自动 从 
Google Play 商店 更 新 。 等 Android 发 布 新 系统 版 本 才能 升级 安全 补丁 或 
用 上 新 功能 的 日 子 终于 敖 到 头 了 。 到 了 Nougat (Android 

7.00 ，WebView 的 Chromium 层 又 改 为 直接 来 自 Chrome APK 安 装 包 。 这 
变化 也 太 快 了 。 不 过 ， 无 论 如 何 ， 知 道 Google 一 直 在 更 新 NebView， 我 
们 也 就 放心 了 。 


29.8 深入 学 习 : Chrome Custom Tabs 


我 们 已 经 知道 ， 显 示 网 页 内 容 有 两 种 方式 : 启动 用 户 的 网 页 浏览 器 和 在 
应 用 里 藤 入 网 页 内 容 。 混 合 这 两 种 方式 ，Google 很 快 又 为 开发 人 员 提 供 
了 第 三 种 方式 : Chrome Custom Tabs. 


有 了 Chrome Custom Tabs， 你 可 以 在 应 用 里 启动 一 个 Chrome 网 页 浏览 
器 ， 其 看 起 来 就 像 应 用 里 的 原生 定制 界面 一 般 。 你 也 可 以 定制 Chrome 
Custom Tabs 的 外 观 ， 让 它 看 起 来 已 融入 你 的 应 用 ， 用 户 用 起 来 束 像 没 
离开 过 应 用 一 般 。 图 29-4 所 示 就 是 一 个 使 用 例子 。 可 以 看 到 ， 整 个 画面 
看 起 来 就 是 Google Chrome 和 PhotoPageActivity 的 一 种 混合 。 
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P Gemini VI | This picture of the Gemini . 
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图 29-4 Chrome Custom Tab 


Chrome Custom Tab 用 起 来 和 Chrome 差 不 多 。 它 甚至 能 访问 到 Chrome 浏 
览 器 保存 的 用 户 密码 、 浏 览 器 缓存 和 Cookies。 也 就 是 说 ， 如 果 用 户 在 
Chrome 浏 览 器 里 登录 了 Flickr， 那 么 ， 在 Chrome Custom Tab 里 打开 
Flickr， 也 能 自动 登录 。 显 然 ， 要 是 使 用 WebView， 你 肯定 做 不 到 这 
样 。 


当然 ，Chrome Custom Tab 也 不 是 万 能 的 ， 相 比 WebView， 要 想 控 制 如 
何 显示 内 容 就 没 那 么 容易 了 。 例 如 ，Chrome Custom Tab 无 法 半 屏 显示 


内 容 ， 你 也 无 法 在 其 界面 的 底部 添加 导航 按钮 。 
要 使 用 Chrome Custom Tab， 首 先 要 添加 以 下 依赖 项 : 


implementation 'androidx.browser:browser:1.0.0' 


E ， 就 可 以 编码 启动 Chrome Custom Tab 了 。 例 如， 在 PhotoGallery 
， 你 可 以 这 样 启动 它 : 


class PhotoGalleryFragment : VisibleFragment() { 


private inner class PhotoHolder(private val itemImageView: ImageView) 
: RecyclerView. ViewHolder(itemImageView) , 
View.OnClickListener { 


override fun onClick(view: View) { 


CustomTabsIntent.Builder() 
.setToolbarColor(ContextCompat.getColor( 
requireContext(), R.color.colorPrimary)) 
.setShowTitle(true) 
.build() 
.launchUrl(requireContext(), galleryItem.photoPageUri) 


a, HP gzGKEÉEDE. WMA Fan- ed 《如果 
用 户 设备 上 的 Chrome 版 本 低 于 45， gre gs 会 后 退 使 用 系 
统 浏 览 嚣 ， 这 就 相当 于 用 隐 式 intent 方 式 浏 览 网 页 。 


29.9 ”挑战 练习 :; 使 用 回 退 键 浏览 历史 网 页 


你 或 许 注 意 到 了 ， 启 动 PhotoPageActivity 之 后 ， 还 可 以 在 NebView 中 
点 击 跳 转 到 其 他 链接 。 然 而 ， 不 管 如 何 跳 转 ， 访 问 了 多 少 个 网 页 ， 只 要 
按 回 退 键 ， 就 会 立即 回 到 PhotoGalleryActivity。 如 果 想 使 用 回 退 键 
在 NebView 里 浏览 历史 网 页 ， 该 怎么 做 呢 ? 


提示 : 首先 覆盖 回 退 键 函 数 Activity.onBackpPressed()。 在 该 函数 
内 ， 再 搭配 使 用 WebView 的 历史 记录 浏览 函数 
(WebView.canGoBack() 和 WebView.goBack()) 实现 想 要 的 浏览 罗 
辑 。 如 果 WebView 里 有 历史 浏览 记录 ， 就 回 到 前 一 个 历史 网 页 ， 否 则 调 
Fa super.onBackPressed() #25] #/PhotoGalleryActivity. 


第 30 章 ” 定 制 视 图 与 触摸 事件 


本 章 ， 通 过 开发 一 个 名 为 BoxDrawingView 的 定制 View 子 类 ， 我 们 来 学 
习 如 何 处 理 触摸 事件 。 在 新 项 目 DragAndDraw 中 ， 这 个 定制 View 会 响应 
用 户 的 触摸 与 拖 动 ， 在 屏幕 上 绘制 出 矩形 框 ， 如 图 30-1 所 示 。 


9:00 b UE 


DragAndDraw 


图 30-1 各 种 形状 大 小 的 绘制 框 


30.1 创建 DragAndDraw 项 日 


创建 DragAndDraw 新 项 目 ， 最 低 SDK 版 本 选择 API 21 并 使 用 AndroidX 
artifacts。 新 建 空 启 动 activity 并 命名 为 DragAndDrawActivity。 


DragAndDrawActivity 是 AppCompatActivity 的 子 类 ， 它 的 布局 
由 BoxDrawingView 定 制 视图 组 成 。 稍 后 会 创建 这 个 定制 视图 
类 。BoxDrawingView 会 处 理 所 有 的 图 形 绘制 和 触摸 事件 。 


30.2 ”创建 定制 视图 


Android 为 开发 者 准备 了 很 多 标准 视图 与 部 件 ， 但 有 了 时 为 退 求 独特 的 应 

用 视觉 效果 ， 创 建 定制 视图 不 可 避免。 

昌 然 定制 视图 很 多 ， 但 总 体 归 为 以 下 两 大 类 别 。 

e 简单 视图 。 简 单 视 图 内 部 也 可 以 很 复杂 ， 之 所 以 归 为 简单 类别 ， 是 
T E Quand SM E MEG 
I} o 

。 聚合 视图 。 聚 合 视 图 由 其 他 视图 对 象 组 成 。 聚 合 视 图 通常 用 来 管理 
子 视图 ， 但 不 负责 处 理 定制 绘制 。 图 形 绘制 任务 都 委托 给 了 各 个 子 
视图 。 


以 下 为 创建 定制 视图 的 三 个 步骤 。 

(1) 选择 超 类 。 对 于 简单 定制 视图 而 言 ，View 是 个 空白 画布 ， 因 此 它 作 
为 超 类 最 常见 。 对 于 聚合 定制 视图 ， 我 们 应 选择 合适 的 超 类 布局 ， 比 如 
FrameLayout. 

(2) ARR EEE, Al ERK A TE ER BL 

(3) it HABE AB, WE HAT A 


创建 BoxDrawingView 视 图 

BoxDrawingView 是 个 简单 视图 ， 同 时 也 是 View 的 直接 子 类 。 

以 View 为 超 类 ， 新 建 BoxDrawingView 类 。 在 BoxDrawingView.kt 中 ， 

添加 一 个 构造 函数 。 该 构造 函数 需要 两 个 参数 : 一 个 是 Context 对 象 ， 
另 一 个 是 默认 值 为 nu11 的 可 空 AttributeSet， 如 代码 清单 30-1 所 示 。 


代码 清单 30-1 初始 BoxDrawingView 视 图 类 
(BoxDrawingView.kt) 


class BoxDrawingView(context: Context, attrs: AttributeSet? = null) : 
View(context, attrs) { 


设置 AttributeSset 默 认 值 为 空 的 妙 处 是 ， 一 下 吏 为 视图 提供 了 两 个 构 
造 函 数 。 这 两 个 构造 函数 都 是 必需 的 ， 因 为 视图 可 从 代码 或 者 布局 文件 
实例 化 。 从 布局 文件 中 实例 化 的 视图 会 收 到 一 个 AttributeSet 实 例 ， 
该 实例 包含 了 XML 布局 文件 中 指定 的 XML 属性 。 即 使 不 打算 使 用 这 两 
个 构造 函数 ， 按 习惯 做 法 也 应 添加 它们 。 


接 下 来 ， 更 新 res/layout/activity_drag_and_draw.xml 布 局 文件 ， 以 使 
用 BoxDrawingView 视 图 ， 如 代码 清单 30-2 所 示 。 


代码 清单 30-2 在 布局 中 添 


加 BoxDrawingView (res/layout/activity_drag_and_draw.xml ) 


PERL TA TET Dp. TS 


«com.bignerdranch.android.draganddraw.BoxDrawingView 
xmlns:android-z"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" /» 


注意 ， 应 给 出 BoxDrawingView 的 全 路 径 类 名 ， 这 样 布局 inflater 才 能 够 
找到 它 。 布 局 inflater 解 析 布 局 XML 文 件 ， 并 按 视 图 定义 创建 View 实 
例 。 如 果 不 给 全 路 径 类 名 ， 布 局 inflater 会 转 而 在 android.view 和 
android.widget 包 中 寻找 同名 类 。 显 然 ， 如 果 目 标 视图 类 在 其 他 包 里 ， 那 
么 布局 inflater 束 找 不 到 它 ， 应 用 就 会 朋 溃 。 


此 ， 对 于 android.view 和 android.widget 包 以 外 的 定制 视图 类 ， 必 须 指 
定 它们 的 全 路 径 类 名 。 


运行 DragAndDraw 应 用 ， 如 果 一 切 正 常 ， 屏 幕 上 会 出 现 一 个 空 视 图 ， 如 
图 30-2 所 示 。 


9:00 


DragAndDraw 


图 30-2 未 绘制 的 BoxDrawingView 


n 让 BoxDrawingView 监 听 和 触摸 事 件 ， 并 根据 指令 在 屏幕 上 绘制 
EHIE. 


30.3 “处理 触摸 事件 
监听 触摸 事件 的 一 种 方式 是 使 用 以 下 View 函 数 ， 设 置 一 个 触摸 事件 监听 
d: 


fun setOnTouchListener(1: View.OnTouchListener) 


该 函数 的 工作 方式 与 setOnClickListener(View.OnClickListener) 
相同 。 实 现 View.OnTouchListener 接 口 ， 供 触摸 事件 发 生 时 触发 调 


用 。 


不 过 ， 由 于 定制 视图 是 View 的 子 类 ， 因 此 也 可 走 捷径 直接 履 羡 以 
下 View 函 数 : 


该 函数 接收 一 个 MotionEvent 类 实例 。 这 个 类 的 作用 是 描述 包括 位 置 和 
的 触摸 事件 。 动 作 的 作用 是 描述 事件 所 处 的 阶段 。 如 表 
30-1 所 不 。 


表 30-1 动作 篆 量 与 动作 描述 


动作 常量 动作 描述 
ACTION_DOWN 手指 触摸 到 屏幕 


ACTION_MOVE 手指 在 屏幕 上 移动 
ACTION_UP 手指 离开 屏幕 


ACTION_CANCEL 父 视图 拦截 了 触摸 事件 


在 onTouchEvent(MotionEvent) 实 现 中 ， 可 调用 以 下 MotionEvent 函 
数 查 看 动作 值 : 


final fun getAction(): Int 


在 BoxDrawingView.kt 中 ， 添 加 一 个 日 志 tag， 然 后 实现 
onTouchEvent(MotionEvent) 函 数 ， 记 录 可 能 发 生 的 四 个 不 同 动作 ， 
如 代码 清单 30-3 所 示 。 


代码 清单 30-3 ”实现 BoxDrawingView 视 图 类 
(BoxDrawingView.kt ) 


private const val TAG = "BoxDrawingView" 


class BoxDrawingView(context: Context, attrs: AttributeSet? = null) : 
View(context, attrs) { 


override fun onTouchEvent(event: MotionEvent): Boolean { 
val current = PointF(event.x, event.y) 
var action = "" 
when (event.action) ( 
MotionEvent.ACTION DOWN -> ( 
action = "ACTION DOWN" 
} 
MotionEvent.ACTION_MOVE -> { 
action = "ACTION MOVE" 
} 
MotionEvent.ACTION_UP -> { 
action = "ACTION_UP" 
} 
MotionEvent.ACTION_CANCEL -> { 
action = "ACTION_CANCEL" 
} 
} 


Log.i(TAG, "$action at x=${current.x}, y=${current.y}") 


return true 


注意 ，X MY 坐标 已 经 封装 到 一 个 名 为 PointF 的 对 象 中 。 稍 后 ， 我 们 需 
d Android 提 供 的 PointF 容 器 类 刚好 满足 了 这 


运行 DragAndDraw 应 用 并 打开 LogCat 窗 口 。 触 摸 屏幕 并 移动 手指 〈 在 模 
拟 设备 上 是 点 击 并 拖 上 忠 ) 。 可 以 看 到 ，BoxDrawingView 接 收 的 每 一 个 
触摸 动作 的 X AY 坐标 都 被 记录 了 下 来 。 

跟踪 运动 事件 


不 仅仅 是 记录 坐标 ，BoxDrawingView 还 要 能 在 屏幕 上 绘制 矩形 框 。 要 
实现 这 一 目标 ， 有 几 个 问题 需要 解决 。 


首先 ， 要 知道 定义 矩形 框 的 两 个 坐标 点 : 原始 坐标 点 (手指 的 初始 位 


置 ) 和 当前 坐标 点 《手指 的 当前 位 置 ) 。 


其 次 ， 定 义 一 个 矩形 框 ， 还 需 追 踪 记 录 来 自 多 个 MotionEvent 的 数据 。 
这 些 数据 会 保存 在 Box 对 象 中 。 


新 建 一 个 Box 关 ， 用 于 表示 一 个 矩形 框 的 定义 数据 ， 如 代码 清单 30-4 所 
ZN o 


代码 清单 30-4 ”添加 Box 类 (Box.kt) 


class Box(val start: PointF) { 
var end: PointF = start 


left: Float 
get() = Math.min(start.x, 


right: Float 


get() = Math.max(start.x, 


top: Float 
get() = Math.min(start.y, 


bottom: Float 
get() = Math.max(start.y, 


用 户 触 措 BoxDrawingView 视 图 界面 时 ， 新 Box 对 象 会 创建 并 添加 到 现 
有 和 矩形 框 数组 中 ， 如 图 30-3 所 示 。 


BoxDrawingView 


boxen currentBox 


Bs 
Ef PointF start 
PointF end 


图 30-3” DragAndDraw 应 用 中 的 对 象 


回 到 BoxDrawingView 类 中 ， 使 用 新 创建 的 Box 对 象 跟 路 绘制 状态 ， 如 
代码 清单 30-5 所 示 。 


代码 清单 30-5 ”添加 拖 忠 生命 周期 函数 (BoxDrawingView.kt) 


class BoxDrawingView(context: Context, attrs: AttributeSet? = null) : 
View(context, attrs) { 


private var currentBox: Box? = null 
private val boxen = mutableListOf<Box>() 


override fun onTouchEvent(event: MotionEvent): Boolean { 
val current = PointF(event.x, event.y) 
var action = "" 
when (event.action) ( 

MotionEvent.ACTION DOWN -> ( 
action = "ACTION DOWN" 

// Reset drawing state 

currentBox - Box(current).also ( 
boxen.add(it) 

} 

} 

MotionEvent.ACTION_MOVE -> { 
action = "ACTION_MOVE" 
updateCurrentBox(current) 

} 

MotionEvent.ACTION_UP -> { 
action = "ACTION_UP" 
updateCurrentBox(current) 
currentBox = null 

} 

MotionEvent.ACTION_CANCEL -> { 
action = "ACTION_CANCEL" 
currentBox = null 


} 
Log.i(TAG, "$action at x=${current.x}, y=${current.y}") 


return true 


} 


private fun updateCurrentBox(current: PointF) { 
currentBox?.let { 


it.end = current 
invalidate() 


任何 时 候 ， 只 要 接收 到 ACTION_DONN 动 作 事 件 ， 就 以 事件 原始 坐标 新 建 
Box 对 象 并 赋值 给 currentBox， 然 后 再 添加 到 甜 形 框 集合 中 。 〈30.4 节 
处 理 定制 绘制 时 ，BoxDrawingView 会 在 屏幕 上 绘制 集合 中 的 全 部 
Box. ) 


用 户 手指 在 屏幕 上 移动 时 ，currentBox .end 会 得 到 更 新 。 在 触摸 事件 
被 取消 或 用 户 手 指 离开 屏幕 时 ， 清 空 cCurrentBox 以 结束 屏幕 绘制 。 已 
a 但 它们 再 也 不 会 受 任何 动作 事件 影 
lj] f. 


注意 在 updateCurrentBox() 里 调用 的 invalidate() 函 数 。 这 会 强 
制 BoxDrawingView 重 新 绘制 自己 。 这 样 ， 用 户 在 屏幕 上 拖 电 时 就 能 实 
时 看 到 和 矩形 框 。 这 同时 也 引出 了 接 下 来 的 任务 : TEBESE E22 EIB HE. 


30.4 ”onDraw(Canvas) 函 数 内 的 图 形 绘制 


应 用 启动 后 ， 所 有 视图 都 处 于 无 效 状态 。 也 就 是 说 ， 视 图 还 没有 绘制 到 
屏幕 上 。 为 解决 这 个 问题 ，Android 调 用 了 顶级 View 视 图 的 draw( ) 子 
数 。 这 会 引起 自 上 而 下 的 链 式 调用 有 反应。 首先， 视图 完成 自我 绘制 ， 接 
着 是 子 视图 的 自我 绘制 ， 然 后 是 子 视图 的 子 视图 的 自我 绘制 ， 如 此 调用 
下 去 直至 视图 层级 结构 的 末端 。 当 视图 层级 结构 中 的 所 有 视图 都 完成 自 
我 绘制 后 ， 最 顶级 View 视 图 也 就 生效 了 。 

即便 某 个 视图 还 在 屏幕 上 ， 你 也 可 以 手动 让 它 失 效 。 操 作 系 统 会 因此 重 
新 绘制 这 个 视图 ， 并 做 必要 的 更 新 。 本 例 中 ， 只 要 用 户 移动 手指 绘制 一 
个 新 框 或 改变 某 个 矩形 框 大 小 ， 我 们 都 会 把 BoxDrawingView 标 记 为 失 
效 。 这 样 ， 用 户 绘制 的 时 候 就 能 所 绘 即 所 见 了 。 


为 加 入 这 种 绘制 ， 可 窗 盖 以 下 View 函 数 : 


protected fun onDraw(canvas: Canvas) 


前 面 ， 在 onTouchEvent(MotionEvent) 函 数 中 啊 应 ACTION_MOVE 动 作 
时 ， 我 们 调用 invalidate() 函 数 再 次 让 BoxDrawingView 失 效 。 这 会 
迫使 它 重 新 自我 绘制 ， 并 再 次 调用 onDraw(Canvas ) 函数 。 


现在 一 起 来 看 看 Canvas 参 数 。Canvas 和 Paint 是 Android 系 统 的 两 大 绘 
制 类 。 


e Canvas 类 拥有 我 们 需要 的 所 有 绘制 操作 。 其 函数 可 决定 绘 在 哪里 
IRRITA, ERR AE Fih EET. 

。 Paint 类 决定 如 何 绘制 。 其 函数 可 指定 绘制 图 形 的 特征 ， 例 如 是 否 
填充 图 形 、 使 用 什么 字体 绘制 、 线 条 是 什么 颜色 等 。 


返回 BoxDrawingView.kt 中 ， 在 BoxDrawingView 完 成 初始 化 后 ， 创 建 两 
个 Paint 对 象 ， 如 代码 清单 30-6 所 示 。 


代码 清单 30-6 创建 Paint (BoxDrawingView.kt) 


class BoxDrawingView(context: Context, attrs: AttributeSet? = null) : 
View(context, attrs) { 


private var currentBox: Box? = null 
private val boxen = mutableListOf<Box>() 
private val boxPaint = Paint().apply { 


color = 0x22ff0000.toInt() 

j 

private val backgroundPaint = Paint().apply { 
color = Oxfff8efe0.toInt() 


} 


oo 象 的 文 持 ， 现 在 能 在 屏幕 上 绘制 窍 形 框 了 ， 如 代码 清单 30- 
7HTZIN o 


代码 清单 30-7 JB uonDraw(Canvas)rEZi (BoxDrawingView.kt) 


class BoxDrawingView(context: Context, attrs: AttributeSet? = null) : 
View(context, attrs) 


override fun onDraw(canvas: Canvas) ( 
// Fill the background 
canvas.drawPaint(backgroundPaint) 


boxen.forEach { box -> 
canvas.drawRect(box.left, box.top, box.right, box.bottom, boxPa 


以 上 代码 的 第 一 部 分 简单 直接 : 使 用 米 日 背景 paint， 填 充 canvas 以 衬托 


AEJEAE 
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值 作 为 最 大 值 。 


完成 位 置 坐 标 值 计算 后 ， 调 用 Canvas.drawRect(...) 函 数 ， 在 屏幕 上 
绘制 红色 和 矩形 框 。 


运行 DragAndDraw 应 用 ， 誉 试 绘制 一 些 红色 矩形 框 ， 如 图 30-4 所 示 。 


9:00 Vices 


DragAndDraw 


图 30-4 程序 员 式 的 情绪 表达 
好 了 ， 一 个 捕捉 触摸 事件 并 自我 绘制 的 视图 创建 完成 了 。 


30.5 ”深入 学 习 : GestureDetector 


处 理 触 摸 事 件 还 有 男 一 个 办 法 : 使 用 GestureDetector 对 象 。 有 了 
它 ， 你 不 用 自己 写 代 码 去 探测 轻 扫 还 是 狐 滑 这 样 的 动作 事件 了 ， 因 
为 GestureDetector 的 监听 器 可 以 做 这 些 繁杂 的 事 ， 并 能 在 动作 事件 
发 生 时 通知 你 。 像 长 按 、 猛 滑 、 滚 动 这 些 动作 事 

件 ，GestureDetector .0nGestureListener 实 现 都 有 相应 的 函数 可 以 
处 理 。 即 便 是 双击 这 样 的 动作 ， 也 有 一 

个 GestureDetector .OnDoubleTapListener 可 以 使 用 。 大 多 数 情况 
下 ， 如 果 不 需 要 履 盖 onTouch 函 数 完 全 控制 如 何 处 理 触摸 事件 ， 那 


么 GestureDetector 就 是 个 不 错 的 选择 。 


30.6 ”挑战 练习 : 设备 旋转 问题 


设备 旋转 后 ， 已 绘制 的 矩形 框 会 消失 。 要 解决 这 个 问题 ， 可 使 用 以 
FView ät: 


protected fun onSaveInstanceState(): Parcelable 
protected fun onRestoreInstanceState(state: Parcelable) 


以 上 函数 的 工作 方式 不 同 于 Activity 和 Fragment 的 
onSaveInstanceState(Bundle) 函 数 。 首 先 ，View 视 图 有 ID 时 ， 才 可 
以 调用 它们 。 其 次 ， 相 较 于 Bundle 参 数 ， 这 些 函 数 返 回 并 处 理 的 是 实 
现 Parcelable 接 口 的 对 象 。 


我 们 推荐 使 用 Bundle， 这 样 就 不 用 自己 实现 Parcelable 接 口 了 。 
(Kotlin 有 一 个 @Parcelize 注 解 ， 可 以 让 Parcelable 类 的 创建 容易 一 
些 。 但 Android 开 发 最 常用 的 还 是 Bundle， 大 多 数 开 发 人 员 更 了 解 
in 

最 后 ， 还 需要 保存 BoxDrawingView 的 View 父 视图 的 状态 。 在 新 建 
Bundle 中 保存 super .onSaveInstanceState() 函 数 的 结果 ， 然 后 调 
用 super .onRestoreInstanceState(Parcelable) 函 数 把 保存 结果 发 
送 给 超 类 。 


30.7 ”挑战 练习 : 旋转 矩形 框 


请 实现 以 两 根 手 指 旋转 矩形 框 。 这 个 练习 有 点 难 ， 想 完成 它 ， 需 
在 MotionEvent 实 现代 码 中 处 理 多 个 触 控 点 (pointer) 。 当 然 ， 还 要 旋 
转 canvas。 


要 处 理 多 点 触摸 ， 先 清楚 以 下 概念 。 


e pointer index: 获知 当前 一 组 触 控 点 中 ， 动 作 事件 对 应 的 触 控 点 。 
e pointer ID: 给 予 手势 中 特定 手指 一 个 唯一 的 ID。 


pointer index 可 能 会 变 ， 但 pointer ID 绝对 不 会 变 。 


请 但 阅 开发 者 文档 ， 学 习 以 下 MotionEvent 子 数 的 使 用 : 


final fun getActionMasked(): Int 
final fun getActionIndex(): Int 


final fun getPointerId(pointerIndex: Int): Int 
final fun getX(pointerIndex: Int): Float 
final fun getY(pointerIndex: Int): Float 


另外 ， 还 需 查 查 ACTION_POINTER_UP 和 ACTION_POINTER_DOWN 常 量 的 
用 法 。 


30.8 HRAJ: 辅助 功能 支持 


Android 内 置 部 件 都 有 类 似 TalkBack 和 Switch Access 这 样 的 辅助 功能 

持 。 自 制 部 件 也 应 负 起 责任 ， 提 供 辅 助 功能 支持 ， 让 应 用 易 用 。 请 完成 
本 章 最 后 一 个 挑战 练习 ， 让 BoxDrawingView 支 持 内 容 描述 ， 配 合 
TalkBack 供 视力 差 的 人 使 用 。 


具体 实现 方法 有 多 个 。 比 如 ， 你 可 以 给 出 屏幕 视图 的 概述 数据 ， 告 诉 用 
户 和 矩形 框 计 住 了 多 大 区 域 的 屏 医 视图 。 或 者 ， 你 也 可 以 把 每 个 窍 形 框 都 
变 成 可 选择 对 象 ， 让 其 告诉 用 户 目 己 在 屏幕 上 的 具体 位 置 。 有 关 应 用 如 
何 文 持 辅助 功能 的 更 多 信息 ， 请 参阅 第 18 章 。 


"B 315 属性 动画 


写 个 基本 可 用 的 应 用 ， 只 要 代码 没 错 ， 运 行 起 来 不 于 省 就 可 以 了 。 至 于 
号 出 用 户 想 用 、 爱 用 的 应 用 ， 光 代码 不 出 错 还 不 够 ， 你 还 得 花 更 多 的 心 

最 好 能 模拟 物理 世界 ， 让 用 户 在 手机 或 平板 设备 上 束 有 真 
ZI 为 的 感受 。 


真实 世界 是 灵动 的 。 要 让 用 户 界 面 动 起 来 ， 用 户 界 面 元 素 需 要 从 一 个 位 
置 动态 移动 到 另 一 个 位 置 。 


本 章 ， 我 们 来 开发 一 个 模拟 落日 景象 的 应 用 。 按 住 屏 医 ， 太 阳 会 慢 慢 落 
下 海平 面 ， 天 空 的 颜色 随 之 不 断 变换 ， 犹 如 真 的 日 沙 。 


31.1 建立 场景 


首先 是 创建 动画 场景 。 创建 一 个 名 为 Sunset 的 新 项 目 ， 确 保 
minSsdkVersion 设 置 为 API 21， 并 使 用 空 activity 模 板 和 AndroidX 
artifacts 。 


海边 落日 光影 变换 ， 色 彩 斑 阐 。 因 此 ， 需 要 准备 一 些 色 彩 资 源 。 打 开 
res/values 目 录 中 的 colors.xml 文 件 。 参 照 代码 清单 31- 1 添加 一 些 颜色 值 。 


代码 清单 31-1 添加 落日 色彩 (res/values/colors.xml) 


<resources> 
«color name="colorPrimary" >#008577</color> 
«color name="colorPrimaryDark" >#@0574B</color> 
«color name="colorAccent">#D81B60</color> 


«color name="bright_sun" >#fcfcb7</color> 

<color name="blue_sky">#1e7ac7</color> 

«color name="sunset_sky">#ec8100</color> 

«color name="night_sky">#05192e</color> 

«color namez"sea"»1224869«/color» 
</resources> 


里 然 矩 形 视 图 模拟 天 空 和 大 海 的 效果 还 可 以 ， 但 没 人 见 过 方 方 长 长 的 太 


BHIE? 技术 实现 简单 可 不 是 理由 。 所 以 ， 在 res/drawable/ 目 录 中 ， 新 建 
一 个 sun.xml 椭 圆 形 drawable 资 源 ， 如 代码 清单 31-2 所 示 。 


代码 清单 31-2 ”添加 模拟 太阳 的 XML 


drawable (res/drawable/sun.xml ) 


«shape xmlns:android="http://schemas.android.com/apk/res/android" 
android: shape="oval"> 


«solid android: color="@color/bright_sun" /> 
</shape> 
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接 下 来 ， 使 用 一 个 完整 的 布局 文件 构建 整个 场景 。 打 开 
res/layoutactivity_main.xml 文 件 ， 删 除 原 有 内 容 ， 添 加 代码 清单 31-3 所 
示 内 容 。 


代码 清单 31-3 ”创建 落日 场景 布局 (res/layout/activity_main.xml ) 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: id="@t+id/scene" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height-"match parent"» 
«FrameLayout 
android:id-"(id/sky" 
android: layout_width="match_parent" 
android: layout_height="@dp" 
android: layout_weight="0.61" 
android: background="@color/blue_sky"> 
<ImageView 
android: id="@+id/sun" 
android: layout_width="10@dp" 
android: layout_height="10@dp" 
android: layout_gravity="center" 
android:src="@drawable/sun" /> 
</FrameLayout> 
<View 
android: layout_width="match_parent" 
android: layout_height="@dp" 
android: layout_weight="0.39" 
android: background="@color/sea" /> 


</LinearLayout> 


DET la. GAR, KERA KAY, ZAMAN HH! xs 
行 Sunset 应 用 。 如 果 一 切 正常 ， 可 看 到 如 图 31-1 所 示 的 画面 。 


Sunset 


图 31-1 落日 徐徐 
31.2 ”人 简单 属性 动画 

创建 完 落日 场景 ， 是 时 候 让 各 个 部 分 按 要 求 动 起 来 ， 实 现 太阳 徐徐 落下 
海平 面 的 动画 效果 了 。 


制作 动画 之 前 ， 需 要 在 activity 中 获取 一 些 必要 的 信息 。 
在 onCreate(...) 函 数 中 ， 获 取 要 控制 的 视图 并 存 入 相应 属性 ， 如 代码 


清单 31-4 所 示 。 


代码 清单 31-4 ”获取 视图 并 引用 CMainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var sceneView: View 
private lateinit var sunView: View 
private lateinit var skyView: View 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


sceneView - findViewById(R.id.scene) 
sunView - findViewById(R.id.sun) 
skyView - findViewById(R.id.sky) 


做 完了 准备 工作 ， 接 下 来 就 是 编码 实现 动画 了 了。 从 技术 上 讲 ， 上 所谓 太阳 
沙 下 海平 面 ， 实 际 就 是 平滑 地 移动 sunView 视 图 ， 直 到 它 的 顶部 刚好 与 
天 空 的 底部 边缘 重合 。 既 然 天 空 的 确 部 和 海平 面 的 项 部 是 一 样 的 ， 那 么 
你 可 以 把 sunView 视 图 顶部 的 坐标 变 为 其 父 视图 底部 的 坐标 位 置 。 


太阳 视图 在 大 海 后 面 移动 的 原因 并 没有 那么 显而易见 。 实 际 上 ， 这 和 视 
图 绘制 的 顺序 有 关 。 视 图 按 在 布局 文件 中 定义 的 顺序 被 绘制 出 来 。 布 局 
中 后 定义 的 视图 会 被 绘制 在 先 定 义 的 视图 之 上 。 就 落日 动画 这 个 例子 来 
讲 ， 既 然 太 阳 视 图 在 大 海 视图 之 前 定义 ， 那 么 ， 大 海 视 图 束 会 被 绘制 在 
er 这 样 一 来 ， 太 阳 移 动 经 过 大 海 时 ， 就 好 像 在 它 的 后 面 穿 
行 一 般 。 


显然 ， 这 需要 知道 动画 的 开始 和 结束 点 。 这 个 任务 就 交 给 
startAnimation() 函 数 处 理 吧 ， 如 代码 清单 31-5 所 示 。 


代码 清单 31-5 ”获取 视图 的 项 部 坐标 位 置 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


} 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


} 


top 属 性 是 View 的 top、bottom、right 和 1left 四 个 属性 中 的 一 个 ， 其 
可 以 返回 自己 的 local layout rect. rect (rectangle 的 缩写 形式 ) 指 的 是 视 
图 的 长 方形 边框 。 视 图 的 local layout rect 是 其 相对 父 视图 的 位 置 和 尺寸 
大 小 的 摘 述 。 视 图 一 旦 实例 化 ， 这 些 值 就 相对 固定 下 来 了 。 


虽然 可 以 修改 这 些 值 ， 从 而 改变 视图 的 位 置 ， 但 并 不 推荐 这 么 做 。 要 知 
道 ， 每 次 布局 切换 时 ， 这 些 值 都 会 被 重 置 ， 因 此 才 会 有 相对 固定 一 说 。 
无 论 怎样 ， 动 画 的 开始 点 都 是 sunView 视 图 的 顶部 位 置 。 结 束 点 是 其 父 
视图 skyView 的 底部 位 置 。 移 动 距离 是 调用 height.toFloat() 人 返回 的 
skyView 高 度 。 实 际 上 ，bottom 和 top 属 性 值 之 差 就 是 neight 属 性 值 。 


知道 了 动画 的 开始 和 结束 点 ， 创 建 一 个 0bjectAnimator 对 象 执行 动 
男 ， 如 代码 清单 31-6 所 示 。 


代码 清单 31-6 ”创建 模拟 太阳 的 animator 对 象 (MainActivity.kt) 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


val heightAnimator = ObjectAnimator 


.ofFloat(sunView, "y", sunYStart, sunYEnd) 
.setDuration(3000) 


heightAnimator.start() 


在 onCreate() 函 数 中 ， 为 sceneView 视 图 设置 监听 器 。 只 要 用 户 点 击 
日 落 场 景 的 任何 地 方 ， 就 调用 startAnimation() 函 数 执行 动画 ， 如 代 
码 清单 31-7 所 示 。 


代码 清单 31-7 ”响应 点 击 ， 执 行动 画 〈MainActivity.kt) 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


sceneView - findViewById(R.id.scene) 
sunView - findViewById(R.id.sun) 
skyView - findViewById(R.id.sky) 


sceneView.setOnClickListener { 
startAnimation() 


) 


运行 Sunset 应 用 。 点 击 应 用 界面 任意 处 ， 执 行动 画 ， 如 图 31-2 所 示 。 
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Sunset 


图 31-2 落日 落下 海平 面 


你 应 该 看 到 ， 太 阳 移 动 到 海平 面 以 下 了 。 

最 后 ， 来 看 看 这 段 动画 的 实现 原理 : 0bjectAnimator 是 个 属性 动画 制 
作对 象 。 要 获得 茶 种 动画 效果 ， 传 统 方式 是 设法 在 屏 硕 上 移动 视图 ， 属 
E 以 一 组 不 同 的 参数 值 反 复 调 用 属性 设置 函 


你 可 以 调用 ObjectAnimator .ofFloat(sunView，"y"，6，1) 来 创建 
一 个 ObjectAnimator 对 象 。 新 建 0bjectAnimator 一 旦 启动 ， 就 会 以 
从 0 开始 递增 的 参数 值 反 复 调 用 sunView.setY(Float) 郴 数 : 


sunView. setY(@) 
sunView.setY(0.02) 
sunView.setY(0.04) 


sunView.setY(0.06) 
sunView.setY(0.08) 


直到 调用 sunView.setY(1) 为 止 。 这 个 0~1 区 间 参 数值 的 确定 过 程 又 称 

为 interpolation。 可 以 想象 到 ， 在 这 个 interpolation 过 程 中 ， 即 便 很 短 

暂 ， 确 定 相 邻 参 数值 也 是 要 耗费 时 间 的 。 由 于 人 眼 的 视觉 暂 留 现象 ， 动 
画 效 果 就 形成 了 。 


31.2.1 视图 转换 属性 


如 果 想 让 视图 动 起 来 ， 仅 仅 靠 属性 动画 制作 对 象 是 不 切实 际 的 ， 尽 管 它 
确实 很 有 用 。 现 代 Android 属 性 动画 需要 转换 属性 En 
properties) 这 个 帮手 。 


前 面 说 过 ， 视 图 都 有 local layout rect〈 视 图 实例 化 时 被 赋予 的 位 置 及 大 
小 尺寸 参数 值 〉。 知 道 了 视图 属性 值 (local layout rect) ， 束 可 以 改变 
这 些 属 性 值 ， 从 而 实现 四 处 移动 视图 。 这 种 做 法 就 叫 作 转换 属性 。 例 
如 ， 利 用 rotation、pivotX 和 pivotY 这 三 个 参数 可 以 旋转 视图 (参见 
图 31-3) ; 利用 scaleX 和 scaleY 可 以 缩放 视图 (参见 图 31-4) ; 而 利 
用 translationX 和 translationY 可 以 四 处 移动 视图 (参见 图 31-5) 。 


pivotX & 
pivotY 


图 31-3 ”视图 旋转 


ScaleY 


图 31-4 视图 缩放 


translationX & 
translationY 


图 31-5 ”视图 移动 


视图 的 所 有 这 些 属 性 值 都 能 被 获取 和 修改 。 例 如 ， 调 
用 view.translationX 就 能 得 到 translLlationX 值 ， 调 
Hiview.translationX = Float 就 能 设置 translationX 值 。 


那么 y 属 性 有 什么 作用 呢 ?” 实 际 上 ，x 和 y 属 性 是 以 布局 坐标 为 参考 值 设 
立 的 一 种 便利 开发 的 属性 值 。 例 如 ， 简 单 写 几 行 代码 ， 就 可 以 把 视图 置 
于 某 个 X FLY 上 华 标 确定 的 位 置 。 分 析 其 背后 原理 可 知 ， 这 束 是 通过 修 
改 translationX 和 translationY 属 性 值 来 实现 的 。 调 用 sunView.y 
= 56 就 等 同 于 : 


31.2.2 ”使 用 不 同 的 interpolator 

Sunset 应 用 的 动画 效果 还 不 够 完美 。 假 设 太阳 一 开始 静止 于 天 
， 在 进入 落下 的 动画 时 ， 应 该 有 个 加 速 过 程 。 这 也 好 办 ， 使 

HirimeInterpolatondkWTbl ]'. 这 个 TimeInterpolator 的 作用 是 : 

改变 A 点 到 B 点 的 动画 效果 。 


如 代码 清单 31-8 所 示 ， 在 startAnimation() 函 数 中 ， 使 用 一 
个 AccelerateInterpolator 对 象 实现 太阳 加 速 落下 的 特效 。 


代码 清单 31-8 ”添加 加 速 特效 (MainActivity.kt) 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


val heightAnimator = ObjectAnimator 
.ofFloat(sunView, "y", sunYStart, sunYEnd) 
.setDuration(3000) 

heightAnimator.interpolator = AccelerateInterpolator() 


heightAnimator.start() 


s oe Mee 这 次 ， 太 阳 先 是 慢 慢 落 
， 然 后 明 着 海平 面 方向 加 速 哈 


使 用 不 同 的 TimeInterpolator 对 象 可 实现 不 同 的 动画 特效 。 想 要 了 解 


Android 自 带 的 TimeInterpolator 还 有 哪些 ， 请 参 
fi] TimeInterpolator# % X fWHJKnown Indirect Subclasses 部 分 。 


31.2.3. ”色彩 渐变 

优化 完 落 日 的 动画 效果 ， 接 着 处 理 天 空 随 日 落 所 呈现 的 色彩 变换 效果 。 
在 onCreateView(...) 函 数 中 ， 获 取 colors.xml 文 件 定义 的 色彩 资源 并 
存 入 相应 的 属性 ， 如 代码 清单 31-9 所 示 。 


代码 清单 31-9 取出 日 落 色彩 资源 (MainActivity.kt) 


class MainActivity : AppCompatActivity() { 


private lateinit var sceneView: View 
private lateinit var sunView: View 
private lateinit var skyView: View 


private val blueSkyColor: Int by lazy { 
ContextCompat.getColor(this, R.color.blue_sky) 

} 

private val sunsetSkyColor: Int by lazy { 
ContextCompat.getColor(this, R.color.sunset_sky) 

} 

private val nightSkyColor: Int by lazy { 
ContextCompat.getColor(this, R.color.night_sky) 

} 


} 


fEstartAnimation() mar, Hin ObjectAnimator, KMR 
空 色彩 从 blueSkyColor 到 sunsetSkyColor 变 换 的 动画 效果 ， 如 代码 
清单 31-10 所 示 。 


代码 清单 31-10 ”实现 天 空 的 色彩 变换 (MainActivity.kt) 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


val heightAnimator - ObjectAnimator 
.ofFloat(sunView, "y", sunYStart, sunYEnd) 
.setDuration(3000) 

heightAnimator.interpolator = AccelerateInterpolator() 


val sunsetSkyAnimator = ObjectAnimator 
.ofInt(skyView, "backgroundColor", blueSkyColor, sunsetSkyColor) 
.setDuration(3000) 


heightAnimator.start() 
sunsetSkyAnimator.start() 


ARE SY ARM IA SEM So 24T Sunse VHA AI. WERK 
HDH! NG BSE, AAA ARIAS aK Yo 7 SOLE B 


仔细 分 析 就 会 知道 ， 颜 色 Int 数 值 并 不 是 个 简单 的 数字 。 它 实际 由 四 个 
较 小 数字 转换 而 来 。 因 此 ， 只 有 知道 颜色 的 组 成 奥 

秘 ，0bjectAnimator 对 象 才能 合理 地 确定 蓝 色 和 橘 黄 色 之 间 的 中 间 
值 。 


不 过 ， 知 道 如 何 确定 颜色 中 间 值 还 不 够 ，0bJjectAnimator 还 需要 一 
个 TypeEvaluator 子 类 的 协助 。TypeEvaluator 能 帮助 
ObjectAnimator 对 象 精确 地 计算 开始 到 结束 间 的 递增 值 。Android 提 供 
的 这 个 TypeEvaluator 子 类 叫 作 ArgbEvaluator， 如 代码 清单 31-11 所 
示 。 


代码 清单 31-11 使 用 ArgbEvaluator (MainActivity.kt) 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


val heightAnimator = ObjectAnimator 
.ofFloat(sunView, "y", sunYStart, sunYEnd) 
.setDuration(3000) 

heightAnimator.interpolator = AccelerateInterpolator() 


val sunsetSkyAnimator = ObjectAnimator 
.ofInt(skyView, "backgroundColor", blueSkyColor, sunsetSkyColor) 
.setDuration(3000) 
sunsetSkyAnimator.setEvaluator(ArgbEvaluator()) 


heightAnimator.start() 
sunsetSkyAnimator.start() 


《有 好 几 个 版 本 的 ArgbEvaluator 可 选 ， 导 入 android.animation 版 
本 。) 


再 次 运行 Sunset 应 用 。 如 图 31-6 所 示 ， 夕 阳 西 下 ， 天 空 从 蓝 色 到 权 黄 
色 ， 色 彩 的 过 渡 终 于 自然 了 。 
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Sunset 


图 31-6 ”天 空 的 色彩 随 日 落 变换 


313 ”播放 多 个 动画 
有 时 你 需要 同时 执行 一 些 动画 。 这 很 简单 ， 同 时 调用 start() 函 数 就 
行 了 。 


但 是 ， 假 如 要 像 编排 舞步 那样 编排 多 个 动画 的 执行 ， 事 情 束 没 那么 简单 
了 。 例 如 ， 为 实现 完整 的 日 落 景象 ， 太 阳 落 下 去 之 后 ， 天 空 应 该 从 桶 芮 
色 再 转 为 午夜 蓝 。 


办 法 总 是 有 的 ， 你 可 以 使 用 AnimatorListener。AnimatorListener 
会 让 你 知道 动画 什么 时 候 结 束 。 这 样 ， 执 行 完 第 一 个 动画 ， 就 可 以 接力 
执行 第 二 个 夜空 变化 的 动画 。 然 而 ， 理 论 分 析 很 简单 ， 如 果实 际 去 做 ， 


少不了 要 准备 多 个 监听 器 ， 这 也 很 肪 烦 。 好 在 Android 还 设计 了 方便 又 
简单 的 AnimatorSet。 


首先 ， 删 除 原来 的 动画 启动 代码 ， 并 添加 夜空 变化 的 动画 代码 ， 如 代码 
清单 31-12 所 示 。 


代码 清单 31-12 ”创建 夜空 动画 (MainActivity.kt) 


private fun startAnimation() { 
val sunYStart = sunView.top.toFloat() 
val sunYEnd = skyView.height.toFloat() 


val heightAnimator = ObjectAnimator 
.ofFloat(sunView, "y", sunYStart, sunYEnd) 
.setDuration(3000) 

heightAnimator.interpolator = AccelerateInterpolator() 


val sunsetSkyAnimator = ObjectAnimator 
.ofInt(skyView, "backgroundColor", blueSkyColor, sunsetSkyColor) 
.setDuration(3000) 
sunsetSkyAnimator.setEvaluator(ArgbEvaluator()) 


val nightSkyAnimator - ObjectAnimator 
.OflInt(skyView, "backgroundColor", sunsetSkyColor, nightSkyColor) 
.setDuration(1500) 

nightSkyAnimator.setEvaluator(ArgbEvaluator()) 


然后 ， 创 建 并 执行 一 个 AnimatorSset， 如 代码 清单 31-13 所 示 。 


代码 清单 31-13 ”创建 动画 集 CMainActivity.kO 


private fun startAnimation() { 


val nightSkyAnimator = ObjectAnimator 


.ofInt(skyView, "backgroundColor", sunsetSkyColor, nightSkyColor) 
.setDuration(1500) 
nightSkyAnimator.setEvaluator(ArgbEvaluator()) 


val animatorSet - AnimatorSet() 

animatorSet.play(heightAnimator) 
.with(sunsetSkyAnimator ) 
.before(nightSkyAnimator ) 

animatorSet.start() 


说 日 了 ， AnimatorSet 束 是 可 以 放 在 一 起 执行 的 动画 集 。 可 以 用 好 几 种 
方式 创建 动画 集 ， 但 使 用 上 述 代码 中 的 play (Animator) 函 数 最 容易 。 


调用 play (Animator ) 函 数 之 前 ， 要 先 创 建 一 个 AnimatorSet.Builder 
对 象 ， 然 后 利用 它 创 建 链 式 函数 调用 。 传 入 play (Animator) 函 数 的 
Animator 是 链 首 。 以 上 代码 中 的 链 式 调用 可 以 这 样 解读 : 协同 执 
fTheightAnimatorflsunsetSkyAnimatorz/]IH, 

在 nightSskyAnimator 之 前 执行 heightAnimator 动 画 。 在 实际 开发 
中 ， 可 能 会 用 到 更 复杂 的 动画 集 。 这 也 没 问 题 ， 需 要 的 话 ， 可 以 多 次 调 
用 play (Animator) efi Xt. 


再 次 运行 Sunset 应 用 。 用 心 感受 下 这 幅 动 人 祥和 的 画面 ， 真 是 太 棒 了 了 ! 


31.4 深入 学 习 : 其 他 动画 API 


除了 广 受 欢迎 的 属性 动画 ，Android 动 画工 具 箱 里 还 有 一 些 其 他 动画 工 
具 。 不 管用 不 用 ， 花 点 时 间 了 解 一 下 总 没 错 。 


31.44 传统 动画 工具 


Android 有 个 叫 作 android.view.animation 的 动画 TA H% Honeycomb 发 
Ai 时 ， 又 引入 了 一 个 更 新 的 android.animation 包 。 这 是 两 个 不 同 的 包 ， 
请 注意 区 分 。 


它们 都 是 传统 的 动画 工具 包 ， 简 单 了 解 就 可 以 了 。 注 意 到 了 吗 ? 本 章 使 
用 的 动画 工具 类 的 类 名 都 为 animaTOR。 如 果 过 到 animaTION 这 样 的 类 
名 ， 就 能 断定 它 来 目 传 统 动 画工 具 包 ， 直 接 忽略 好 了 ! 


31.4.2 £515 


Android 4.4 引 入 了 新 的 视图 转 场 框 架 。 从 一 个 activity 小 视图 动态 弹出 男 
一 个 放大 版 activity 视 图 就 可 以 使 用 转 场 框 洪 实现 。 


实际 上 ， 转 场 框 架 的 工作 原理 很 简单 :定义 一 些 场景 ， 它 们 代表 各 个 时 
扩 的 视图 状态 ， 然 后 按照 一 定 的 逻辑 切换 场景 。 场 景 在 XML 布 局 文件 
中 定义 ， 转 场 在 XML 动 画 文 件 中 定义 。 


在 本 半日 沙 例 子 中 ，activity 已 经 运行 了 ， 这 种 情况 不 太 适 合 使 用 转 场 框 
架 ， 我 们 用 了 强大 的 属性 动画 框架 。 然 而 ， 属 性 动画 框 染 并 不 擅长 处 理 
竺 显 布局 的 屏幕 动画 。 


再 以 CriminalIntent 应 用 中 处 理 crime 图 片 为 例 ， 如 果 想 实现 以 弹 窗 展示 放 
大 版 图 片 这 样 的 动画 效果 ， 首 先 要 知道 照片 放 在 哪里 ， 其 次 是 如 何在 对 
话 框 里 布置 新 图 片 。 显 然 ， 对 于 这 类 布局 动态 转 场 任务 ， 转 场 框 架 比 
ObjectAnimator 更 能 胜任 。 


31.5 ”挑战 练习 


首先 ， 让 日 沙 可 逆 。 也 就 是 说 ， 点 击 屏 幕 ， 等 太阳 落下 后 ， 再 次 点 击 屏 
幕 ， 让 太阳 升 起 来 。 动 画集 不 能 逆 问 执行 ， 因 此 ， 你 需要 新 建 一 


^*AnimatorSet. 


第 二 个 挑战 是 添加 太阳 动画 特效 ， 让 它 有 规律 地 放大 、 缩 小 或 是 加 一 圈 
旋转 的 光线 。 (这 实际 是 反复 执行 一 段 动画 特效 ， 可 考虑 使 
用 ObjectAnimator 的 setRepeatCount(Int) 函 数 。) 


另外 ， 海 面 上 要 是 有 太阳 的 倒影 就 更 真实 了 。 
最 后 ， 再 来 看 个 项 具 挑 战 的 练习 。 在 日 落 过 程 中 实现 动画 反 转 。 在 太阳 


慢 慢 下 落 时 点 击 屏幕 ， 让 太阳 一 路 回升 至 原来 所 在 的 位 置 。 或 者 ， 在 太 
阳 落 下 进入 夜晚 时 点 击 屏幕 ， 让 太阳 重新 升 回 天 空 ， 就 像 日 出 。 


第 32 章 编 后 语 


恭喜 你 完成 了 本 书 的 学 习 ! 这 很 了 不 起 ， 不 是 人 人 都 能 做 到 的 。 现 在 就 


去 往 赏 一 下 自己 吧 ! 
总 之 ， 辛 苦 付 出 终 有 回报 : 你 已 经 是 一 名 合格 的 Android 开 发 者 了 。 
32.1 终极 挑战 


最 后 ， 请 再 接受 一 个 挑战 : 成 为 一 名 优秀 的 Android 开 发 人 员 。 成 为 优 
秀 的 开发 者 ， 可 以 说 是 千 人 千 途 。 每 个 人 都 应 去 找寻 最 适合 目 己 的 路 。 


那么 


， 路 在 何方 ? 对 此 ， 我 们 有 一 些 建议 。 


编写 代码 。 如 不 加 以 实践 ， 很 快 就 会 筷 记 所 学 知识 。 马 上 行动 ， 参 
与 开发 一 些 项 目 ， 或 者 自己 写 个 简单 应 用 。 无 论 怎 样 ， 不 要 浪费 时 
间 ， 利 用 一 切 机 会 编写 代码 。 

持续 学 习 。 读 完 本 书 ， 你 已 掌握 Android 开 发 领域 的 很 多 知识 。 现 
在 有 开发 灵感 了 吗 ? 挑 你 最 感 兴趣 的 部 分 ， 加 以 实践 ， 写 点 好 玩 
的 。 开 发 时 ， 如 过 到 问题 ， 记 得 经 常 查 阅 相 关 文 档 ， 或 阅读 更 高 级 
主题 的 图 书 。 另 外 ， 也 可 收看 Android 开 发 者 YouTube 频 道 ， 或 收听 
Google 的 Android 开 发 者 播客 。 

参与 技术 交流 。 参 与 本 地 技术 交流 大 会 ， 多 认识 些 乐 于 助人 的 开发 
者 。 参 与 Android 开 发 者 大 会 ， 与 其 他 Android 开 发 人 员 (包括 我 
i. 面对面 交流 。 另 外 ， 还 可 以 关注 一 些 活 跃 在 Twitter 上 的 开发 高 


探索 开源 社区 。 登 录 GitHub 网 站 ， 上 面 有 海量 的 Android 开 发 资 
源 。 找 找 那些 很 酪 的 共享 库 ， 顺 便 看 看 共享 者 页 献 的 其 他 项 目 资 
源 。 同 时 ， 也 请 积极 共享 自己 的 代码 ， 如 果 能 帮 到 别人 ， 那 最 好 不 
过 了 。 另 外 ， 也 可 以 订阅 Android 每 周 邮 件 列 表 ， 及 时 跟踪 了 解 
Android 开 发 社区 新 动 问 。 


32.2 WA E 


来 Twitter 找 我 们 吧 ! 死 莉 丝 河 、 布 莱恩 、 比 尔 和 死 里 斯 的 账号 分 别 是 
(Qkristinmars. @briangardnerdev. @billjings#@cstew. 


如 果 有 兴趣 ， 也 可 以 访问 Big Nerd Ranch 网 站 ， 找 到 “图 书 ” 选 项 ， 看 看 
我 们 的 其 他 指导 书 。 同 时 ， 我 们 还 为 开发 者 提供 课时 一 周 的 各 类 培训 课 
程 ， 可 保证 在 一 周 内 轻松 学 完 。 当 然 ， 如 果 有 高 质量 代码 开发 需求 ， 我 
们 也 可 以 提供 合同 开发 。 更 多 详情 ， 请 访问 Big Nerd Ranch 网 站 。 


32.3 ”致谢 
没有 读者 ， 我 们 的 工作 将 毫 无 意义 。 感 谢 所 有 购买 并 阅读 本 书 的 读者 ! 


作者 简介 


oe Fi 2277-4 PY -R iA (Kristin Marsicano) ，Big Nerd Ranch 高 级 工程 经 
理 、 讲 师 、Android 开 发 者 。 她 对 学 习 、 应 用 开发 以 及 二 者 的 交集 充满 
热情 。 内 上 暇 时 ， 克 者 丝 汀 喜欢 跑步 、 弹 尤 元 里 里 ， 或 与 孩子 一 起 搭 乐高 
积 


布 赖 恩 .加 德 纳 (Brian Gardner) , Big Nerd Ranch 讲 师 、Android 开 发 
者 。 他 是 个 学 习 狂 ， 目 前 正在 深入 研究 最 新 的 Android 库 ， 此 外 还 在 攻 
读 伍 治 亚 理 工学 院 的 机 器 学 习 倾 士 学 位 。 闲 暇 时 ， 布 赖 恩 喜 欢 绘 画 、 烘 
焙 和 旅行 。 


比尔 :菲利普 斯 (Bill Phillips〉，Instagram 软 件 工程 师 ， 前 Big Nerd 
Ranch 讲 师 。 他 与 人 合作 开发 了 广 受 好 评 的 Android 训 练 营 培 训 课 程 ， 并 
为 之 编写 教材 (包括 本 书 的 第 1 版 和 第 2 版 )。 比 尔 非常 懂得 生活 的 平衡 
之 道 ， 能 把 工作 、 音 乐 创作 和 音频 硬件 项 目 这 些 事 安排 得 井井有条 。 


克 里 斯 - 斯 图 尔 特 (Chris Stewart) ，Big Nerd Ranch 工 程 副 总 裁 ， 前 
Android 训 练 营 讲师 。 他 致力 于 不 断 取得 进步 和 精进 技能 。 工 作 之 余 ， 
克 里 斯 喜 欢 远足 和 旅行 。 


看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编 
辑 或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com. 
在 这 里 可 以 找到 我 们 : 


WE @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

WE @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

WE @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精 彩 人 生 
nia 图 灵 教 育 : turingbooks 


091507240605ToBeReplacedWithUserld 


